@wherabouts/sdk 0.2.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/shared-types.ts","../src/http.ts","../src/resources/addresses.ts","../src/resources/devices.ts","../src/resources/geocode.ts","../src/resources/regions.ts","../src/resources/routing.ts","../src/resources/webhooks.ts","../src/resources/zones.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type {\n\tWheraboutsApiErrorPayload,\n\tWheraboutsErrorCode,\n\tWheraboutsFieldError,\n} from \"./shared-types.ts\";\n\nexport class WheraboutsApiError extends Error {\n\treadonly code: WheraboutsErrorCode | \"unknown_error\";\n\treadonly payload: WheraboutsApiErrorPayload | null;\n\treadonly status: number;\n\t/** Correlation id from the `X-Request-Id` header or error body, if present. */\n\treadonly requestId: string | null;\n\t/** Documentation link for this error, if the API provided one. */\n\treadonly docUrl: string | null;\n\t/** Field-level validation detail, if the API provided any. */\n\treadonly fields: WheraboutsFieldError[] | null;\n\n\tconstructor(options: {\n\t\tcode?: WheraboutsApiError[\"code\"];\n\t\tdocUrl?: string | null;\n\t\tfields?: WheraboutsFieldError[] | null;\n\t\tmessage: string;\n\t\tpayload?: WheraboutsApiErrorPayload | null;\n\t\trequestId?: string | null;\n\t\tstatus: number;\n\t}) {\n\t\tsuper(options.message);\n\t\tthis.name = \"WheraboutsApiError\";\n\t\tthis.status = options.status;\n\t\tthis.code = options.code ?? \"unknown_error\";\n\t\tthis.payload = options.payload ?? null;\n\t\tthis.requestId = options.requestId ?? null;\n\t\tthis.docUrl = options.docUrl ?? null;\n\t\tthis.fields = options.fields ?? null;\n\t}\n}\n","export const WHERABOUTS_API_VERSION = \"v1\" as const;\nexport const WHERABOUTS_SDK_VERSION = \"0.2.0\" as const;\n\n/**\n * Error codes the API may return. The server currently emits a subset; the full\n * union is declared for forward-compatibility with the Phase 2 error envelope\n * (see docs/CONTRACT.md §4). Unknown codes fall back to `unknown_error`.\n */\nexport type WheraboutsErrorCode =\n\t| \"bad_request\"\n\t| \"conflict\"\n\t| \"forbidden\"\n\t| \"internal_error\"\n\t| \"not_found\"\n\t| \"rate_limited\"\n\t| \"timeout\"\n\t| \"unauthorized\"\n\t| \"unprocessable\";\n\nexport interface WheraboutsFieldError {\n\tmessage: string;\n\tpath: string;\n}\n\nexport interface WheraboutsApiErrorPayload {\n\terror: {\n\t\tcode: WheraboutsErrorCode;\n\t\tmessage: string;\n\t\t/** Correlation id; also sent as the `X-Request-Id` response header. */\n\t\trequest_id?: string;\n\t\t/** Link to documentation for this error code. */\n\t\tdoc_url?: string;\n\t\t/** Field-level validation detail (validation errors only). */\n\t\tfields?: WheraboutsFieldError[];\n\t};\n}\n\nexport interface WheraboutsClientConfig {\n\tapiKey: string;\n\tbaseUrl?: string;\n\tfetch?: typeof fetch;\n\theaders?: Record<string, string>;\n\t/** Max automatic retries for transient failures. Default 2. */\n\tmaxRetries?: number;\n\t/** Per-request timeout in milliseconds. Default 30000. */\n\ttimeoutMs?: number;\n}\n\n/**\n * Per-call overrides. Every resource method accepts an optional trailing\n * `options` argument of this shape.\n */\nexport interface CallOptions {\n\t/** Extra headers merged over (not replacing) the client headers. */\n\theaders?: Record<string, string>;\n\t/** Idempotency key for write requests. Auto-generated on writes if omitted. */\n\tidempotencyKey?: string;\n\t/** Override the client's `maxRetries` for this call. */\n\tmaxRetries?: number;\n\t/** Abort signal — aborting rejects the call (and is not retried). */\n\tsignal?: AbortSignal;\n\t/** Override the client's `timeoutMs` for this call. */\n\ttimeoutMs?: number;\n}\n\nexport type HttpMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\";\n\nexport interface RequestOptions extends CallOptions {\n\tbody?: unknown;\n\tmethod: HttpMethod;\n\tpath: string;\n\tquery?: Record<string, number | string | undefined>;\n}\n\nexport type Requester = <T>(opts: RequestOptions) => Promise<T>;\n","import { WheraboutsApiError } from \"./errors.ts\";\nimport {\n\ttype HttpMethod,\n\ttype Requester,\n\ttype RequestOptions,\n\tWHERABOUTS_API_VERSION,\n\tWHERABOUTS_SDK_VERSION,\n\ttype WheraboutsApiErrorPayload,\n\ttype WheraboutsClientConfig,\n} from \"./shared-types.ts\";\n\nconst DEFAULT_BASE_URL = \"https://api.wherabouts.com\";\nconst DEFAULT_MAX_RETRIES = 2;\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst BACKOFF_BASE_MS = 200;\nconst BACKOFF_CAP_MS = 5000;\nconst RETRYABLE_STATUSES = new Set([408, 425, 429, 500, 502, 503, 504]);\nconst WRITE_METHODS = new Set<HttpMethod>([\"POST\", \"PUT\"]);\n\nconst createBaseHeaders = (config: WheraboutsClientConfig): Headers => {\n\tconst headers = new Headers(config.headers);\n\theaders.set(\"accept\", \"application/json\");\n\theaders.set(\"authorization\", `Bearer ${config.apiKey}`);\n\theaders.set(\n\t\t\"x-wherabouts-sdk\",\n\t\t`js-ts/${WHERABOUTS_SDK_VERSION} api/${WHERABOUTS_API_VERSION}`\n\t);\n\treturn headers;\n};\n\nconst generateIdempotencyKey = (): string => {\n\tconst cryptoObj = globalThis.crypto;\n\tif (cryptoObj?.randomUUID) {\n\t\treturn cryptoObj.randomUUID();\n\t}\n\t// Fallback for runtimes without crypto.randomUUID.\n\treturn `${Date.now().toString(16)}-${Math.random().toString(16).slice(2)}`;\n};\n\nconst buildRequestHeaders = (\n\tbaseHeaders: Headers,\n\topts: RequestOptions\n): Headers => {\n\tconst headers = new Headers(baseHeaders);\n\tif (opts.headers) {\n\t\tfor (const [key, value] of Object.entries(opts.headers)) {\n\t\t\theaders.set(key, value);\n\t\t}\n\t}\n\tif (opts.body !== undefined) {\n\t\theaders.set(\"content-type\", \"application/json\");\n\t}\n\t// Writes carry an Idempotency-Key so retries are safe (docs/CONTRACT.md §6).\n\tif (WRITE_METHODS.has(opts.method)) {\n\t\theaders.set(\n\t\t\t\"idempotency-key\",\n\t\t\topts.idempotencyKey ?? generateIdempotencyKey()\n\t\t);\n\t} else if (opts.idempotencyKey) {\n\t\theaders.set(\"idempotency-key\", opts.idempotencyKey);\n\t}\n\treturn headers;\n};\n\nconst readRequestId = (response: Response): string | null =>\n\tresponse.headers.get(\"x-request-id\") ??\n\tresponse.headers.get(\"x-wherabouts-request-id\");\n\nconst parseApiError = async (\n\tresponse: Response\n): Promise<WheraboutsApiError> => {\n\tlet payload: WheraboutsApiErrorPayload | null = null;\n\ttry {\n\t\tpayload = (await response.json()) as WheraboutsApiErrorPayload;\n\t} catch {\n\t\tpayload = null;\n\t}\n\tconst message =\n\t\tpayload?.error.message ??\n\t\t`Wherabouts request failed with status ${response.status}`;\n\treturn new WheraboutsApiError({\n\t\tstatus: response.status,\n\t\tmessage,\n\t\tcode: payload?.error.code ?? \"unknown_error\",\n\t\tpayload,\n\t\trequestId: payload?.error.request_id ?? readRequestId(response),\n\t\tdocUrl: payload?.error.doc_url ?? null,\n\t\tfields: payload?.error.fields ?? null,\n\t});\n};\n\n/** Parse a `Retry-After` header (delta-seconds or HTTP-date) to milliseconds. */\nconst parseRetryAfter = (value: string | null): number | null => {\n\tif (!value) {\n\t\treturn null;\n\t}\n\tconst seconds = Number(value);\n\tif (Number.isFinite(seconds)) {\n\t\treturn Math.max(0, seconds * 1000);\n\t}\n\tconst dateMs = Date.parse(value);\n\tif (Number.isNaN(dateMs)) {\n\t\treturn null;\n\t}\n\treturn Math.max(0, dateMs - Date.now());\n};\n\n/** Exponential backoff with full jitter, capped. */\nconst computeBackoff = (attempt: number): number => {\n\tconst exponential = Math.min(BACKOFF_CAP_MS, BACKOFF_BASE_MS * 2 ** attempt);\n\treturn Math.random() * exponential;\n};\n\nconst sleep = (ms: number, signal?: AbortSignal): Promise<void> =>\n\tnew Promise((resolve, reject) => {\n\t\tif (signal?.aborted) {\n\t\t\treject(signal.reason ?? new Error(\"Aborted\"));\n\t\t\treturn;\n\t\t}\n\t\tconst timer = setTimeout(() => {\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\tresolve();\n\t\t}, ms);\n\t\tconst onAbort = () => {\n\t\t\tclearTimeout(timer);\n\t\t\treject(signal?.reason ?? new Error(\"Aborted\"));\n\t\t};\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t});\n\nexport const createRequester = (config: WheraboutsClientConfig): Requester => {\n\tconst fetchImpl = config.fetch ?? globalThis.fetch;\n\tif (!fetchImpl) {\n\t\tthrow new Error(\n\t\t\t\"A fetch implementation is required to create the SDK client.\"\n\t\t);\n\t}\n\tconst baseUrl = new URL(config.baseUrl ?? DEFAULT_BASE_URL);\n\tconst baseHeaders = createBaseHeaders(config);\n\n\treturn async <T>(opts: RequestOptions): Promise<T> => {\n\t\tconst url = new URL(opts.path, baseUrl);\n\t\tif (opts.query) {\n\t\t\tfor (const [key, value] of Object.entries(opts.query)) {\n\t\t\t\tif (value !== undefined) {\n\t\t\t\t\turl.searchParams.set(key, String(value));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tconst headers = buildRequestHeaders(baseHeaders, opts);\n\t\tconst hasBody = opts.body !== undefined;\n\t\tconst body = hasBody ? JSON.stringify(opts.body) : undefined;\n\t\tconst maxRetries =\n\t\t\topts.maxRetries ?? config.maxRetries ?? DEFAULT_MAX_RETRIES;\n\t\tconst timeoutMs = opts.timeoutMs ?? config.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\t\t// GET/PUT/DELETE are idempotent; POST is only retry-safe with a key (always\n\t\t// set for writes above), so every request here is retryable by method.\n\t\tconst callerSignal = opts.signal;\n\n\t\tlet attempt = 0;\n\t\t// Retry loop: returns on success or non-retryable failure; otherwise waits\n\t\t// and continues until `maxRetries` is exhausted.\n\t\twhile (true) {\n\t\t\tconst controller = new AbortController();\n\t\t\tlet timedOut = false;\n\t\t\tconst timeoutId = setTimeout(() => {\n\t\t\t\ttimedOut = true;\n\t\t\t\tcontroller.abort();\n\t\t\t}, timeoutMs);\n\t\t\tconst onCallerAbort = () => controller.abort();\n\t\t\tif (callerSignal) {\n\t\t\t\tif (callerSignal.aborted) {\n\t\t\t\t\tcontroller.abort();\n\t\t\t\t} else {\n\t\t\t\t\tcallerSignal.addEventListener(\"abort\", onCallerAbort, { once: true });\n\t\t\t\t}\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tconst response = await fetchImpl(url, {\n\t\t\t\t\tmethod: opts.method,\n\t\t\t\t\theaders,\n\t\t\t\t\tbody,\n\t\t\t\t\tsignal: controller.signal,\n\t\t\t\t});\n\n\t\t\t\tif (!response.ok) {\n\t\t\t\t\tif (RETRYABLE_STATUSES.has(response.status) && attempt < maxRetries) {\n\t\t\t\t\t\tconst wait =\n\t\t\t\t\t\t\tparseRetryAfter(response.headers.get(\"retry-after\")) ??\n\t\t\t\t\t\t\tcomputeBackoff(attempt);\n\t\t\t\t\t\tattempt++;\n\t\t\t\t\t\tawait sleep(Math.min(wait, BACKOFF_CAP_MS), callerSignal);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tthrow await parseApiError(response);\n\t\t\t\t}\n\n\t\t\t\tif (response.status === 204) {\n\t\t\t\t\treturn undefined as T;\n\t\t\t\t}\n\t\t\t\tconst text = await response.text();\n\t\t\t\treturn (text ? JSON.parse(text) : undefined) as T;\n\t\t\t} catch (error) {\n\t\t\t\t// Caller aborted — never retry; propagate their intent.\n\t\t\t\tif (callerSignal?.aborted) {\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t\t// Our timeout fired — treat like a transient failure.\n\t\t\t\tif (timedOut) {\n\t\t\t\t\tif (attempt < maxRetries) {\n\t\t\t\t\t\tattempt++;\n\t\t\t\t\t\tawait sleep(computeBackoff(attempt - 1), callerSignal);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tthrow new WheraboutsApiError({\n\t\t\t\t\t\tstatus: 0,\n\t\t\t\t\t\tcode: \"timeout\",\n\t\t\t\t\t\tmessage: `Request timed out after ${timeoutMs}ms.`,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\t// A parsed API error (non-retryable status) — surface as-is.\n\t\t\t\tif (error instanceof WheraboutsApiError) {\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t\t// Network/transport error — retry if budget remains.\n\t\t\t\tif (attempt < maxRetries) {\n\t\t\t\t\tattempt++;\n\t\t\t\t\tawait sleep(computeBackoff(attempt - 1), callerSignal);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t} finally {\n\t\t\t\tclearTimeout(timeoutId);\n\t\t\t\tcallerSignal?.removeEventListener(\"abort\", onCallerAbort);\n\t\t\t}\n\t\t}\n\t};\n};\n","import type { CallOptions, Requester } from \"../shared-types.ts\";\n\nexport interface AddressSuggestion {\n\tcountry: string;\n\tformattedAddress: string;\n\tid: number;\n\tlatitude: number;\n\tlocality: string;\n\tlongitude: number;\n\tpostcode: string;\n\tstate: string;\n\tstreetAddress: string;\n}\n\nexport interface AddressRecord {\n\tbuildingName: string | null;\n\tconfidence: number | null;\n\tcountry: string;\n\tflatNumber: string | null;\n\tflatType: string | null;\n\tgnafPid: string | null;\n\tid: number;\n\tlatitude: number;\n\tlevelNumber: string | null;\n\tlevelType: string | null;\n\tlocality: string;\n\tlongitude: number;\n\tnumberFirst: string | null;\n\tnumberLast: string | null;\n\tpostcode: string;\n\tstate: string;\n\tstreetName: string;\n\tstreetSuffix: string | null;\n\tstreetType: string | null;\n}\n\nexport interface NearbyAddress {\n\tbuildingName: string | null;\n\tcountry: string;\n\tdistance: number;\n\tflatNumber: string | null;\n\tflatType: string | null;\n\tid: number;\n\tlatitude: number;\n\tlocality: string;\n\tlongitude: number;\n\tnumberFirst: string | null;\n\tnumberLast: string | null;\n\tpostcode: string;\n\tstate: string;\n\tstreetName: string;\n\tstreetType: string | null;\n}\n\nexport interface ReverseGeocodeAddress {\n\tconfidence: number | null;\n\tcountry: string;\n\tformattedAddress: string;\n\tid: number;\n\tlatitude: number;\n\tlocality: string;\n\tlongitude: number;\n\tpostcode: string;\n\tstate: string;\n\tstreetAddress: string;\n}\n\nexport interface AutocompleteParams {\n\tcountry?: string;\n\tlimit?: number;\n\tq: string;\n\tstate?: string;\n}\n\nexport interface NearbyParams {\n\tcountry?: string;\n\tlat: number;\n\tlimit?: number;\n\tlng: number;\n\tradius?: number;\n}\n\nexport interface ReverseParams {\n\tlat: number;\n\tlng: number;\n}\n\nexport interface AutocompleteResponse {\n\tcount: number;\n\tresults: AddressSuggestion[];\n}\n\nexport interface NearbyResponse {\n\tcount: number;\n\tquery: {\n\t\tlat: number;\n\t\tlng: number;\n\t\tradius: number;\n\t};\n\tresults: NearbyAddress[];\n}\n\nexport interface ReverseResponse {\n\taddress: ReverseGeocodeAddress;\n\tdistance: number;\n\tquery: {\n\t\tlat: number;\n\t\tlng: number;\n\t};\n}\n\nexport interface AddressesResource {\n\tautocomplete(\n\t\tparams: AutocompleteParams,\n\t\toptions?: CallOptions\n\t): Promise<AutocompleteResponse>;\n\tgetById(id: number, options?: CallOptions): Promise<AddressRecord>;\n\tnearby(params: NearbyParams, options?: CallOptions): Promise<NearbyResponse>;\n\treverse(\n\t\tparams: ReverseParams,\n\t\toptions?: CallOptions\n\t): Promise<ReverseResponse>;\n}\n\nexport const createAddresses = (request: Requester): AddressesResource => ({\n\tautocomplete: (params, options) =>\n\t\trequest<AutocompleteResponse>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: \"/api/v1/addresses/autocomplete\",\n\t\t\tquery: {\n\t\t\t\tq: params.q,\n\t\t\t\tcountry: params.country,\n\t\t\t\tstate: params.state,\n\t\t\t\tlimit: params.limit,\n\t\t\t},\n\t\t\t...options,\n\t\t}),\n\tgetById: (id, options) =>\n\t\trequest<AddressRecord>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: `/api/v1/addresses/${id}`,\n\t\t\t...options,\n\t\t}),\n\tnearby: (params, options) =>\n\t\trequest<NearbyResponse>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: \"/api/v1/addresses/nearby\",\n\t\t\tquery: {\n\t\t\t\tlat: params.lat,\n\t\t\t\tlng: params.lng,\n\t\t\t\tradius: params.radius,\n\t\t\t\tlimit: params.limit,\n\t\t\t\tcountry: params.country,\n\t\t\t},\n\t\t\t...options,\n\t\t}),\n\treverse: (params, options) =>\n\t\trequest<ReverseResponse>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: \"/api/v1/addresses/reverse\",\n\t\t\tquery: { lat: params.lat, lng: params.lng },\n\t\t\t...options,\n\t\t}),\n});\n","import type { CallOptions, Requester } from \"../shared-types.ts\";\n\nexport interface BoundaryCrossing {\n\tevent: \"entry\" | \"exit\";\n\tzoneId: number;\n\tzoneName: string;\n}\n\nexport interface PushLocationBody {\n\tlat: number;\n\tlng: number;\n}\n\nexport interface PushLocationResponse {\n\tcrossings: BoundaryCrossing[];\n\tzones: number[];\n}\n\nexport interface DeviceZonesResponse {\n\tdeviceId: string;\n\tlatitude: number | null;\n\tlongitude: number | null;\n\tupdatedAt: string | null;\n\tzoneIds: number[];\n}\n\nexport interface DevicesResource {\n\tpushLocation(\n\t\tdeviceId: string,\n\t\tbody: PushLocationBody,\n\t\toptions?: CallOptions\n\t): Promise<PushLocationResponse>;\n\tzones(deviceId: string, options?: CallOptions): Promise<DeviceZonesResponse>;\n}\n\nexport const createDevices = (request: Requester): DevicesResource => ({\n\tpushLocation: (deviceId, body, options) =>\n\t\trequest<PushLocationResponse>({\n\t\t\tmethod: \"POST\",\n\t\t\tpath: `/api/v1/devices/${deviceId}/location`,\n\t\t\tbody,\n\t\t\t...options,\n\t\t}),\n\tzones: (deviceId, options) =>\n\t\trequest<DeviceZonesResponse>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: `/api/v1/devices/${deviceId}/zones`,\n\t\t\t...options,\n\t\t}),\n});\n","import type { CallOptions, Requester } from \"../shared-types.ts\";\n\n// ---------------------------------------------------------------------------\n// Forward geocode types\n// ---------------------------------------------------------------------------\n\n/**\n * Params for forward geocoding. Provide `q` for unstructured free-text search,\n * OR `street` + `locality` (plus optional `state`, `postcode`, `country`) for\n * structured mode. Set `structured: \"true\"` when using structured fields.\n */\nexport interface ForwardGeocodeParams {\n\t/** ISO 3166-1 alpha-2 country code, e.g. \"AU\". */\n\tcountry?: string;\n\t/** Suburb / locality (structured mode). */\n\tlocality?: string;\n\t/** Postcode / ZIP. */\n\tpostcode?: string;\n\t/** Free-text address query (unstructured mode). */\n\tq?: string;\n\t/** State abbreviation, e.g. \"NSW\". */\n\tstate?: string;\n\t/** Street address (structured mode). */\n\tstreet?: string;\n\t/** Pass `\"true\"` to enable structured mode. */\n\tstructured?: \"true\" | \"false\";\n}\n\nexport interface GeocodeAddress {\n\tcountry: string;\n\tformattedAddress: string;\n\tid: number;\n\tlatitude: number;\n\tlocality: string;\n\tlongitude: number;\n\tpostcode: string;\n\tstate: string;\n\tstreetAddress: string;\n}\n\nexport interface ForwardGeocodeResponse {\n\taddress: GeocodeAddress;\n\tmatchType: \"structured\" | \"fuzzy\";\n}\n\n// ---------------------------------------------------------------------------\n// Batch geocode types\n// ---------------------------------------------------------------------------\n\nexport interface BatchSubmitBody {\n\taddresses: string[];\n}\n\nexport interface BatchSubmitResponse {\n\tinputCount: number;\n\tjobId: string;\n\tstatus: \"pending\" | \"processing\";\n}\n\nexport interface BatchJobStatus {\n\tcompletedAt: string | null;\n\tdownloadUrl: string | null;\n\terror: string | null;\n\tinputCount: number;\n\tjobId: string;\n\tprocessedCount: number | null;\n\tstatus: \"pending\" | \"processing\" | \"completed\" | \"failed\";\n}\n\nexport interface BatchResultsResponse {\n\tcount: number;\n\tresults: unknown[];\n}\n\n// ---------------------------------------------------------------------------\n// Resource factory\n// ---------------------------------------------------------------------------\n\nexport interface GeocodeResource {\n\tbatch: {\n\t\tsubmit(\n\t\t\tbody: BatchSubmitBody,\n\t\t\toptions?: CallOptions\n\t\t): Promise<BatchSubmitResponse>;\n\t\tpoll(jobId: string, options?: CallOptions): Promise<BatchJobStatus>;\n\t\tresults(\n\t\t\tjobId: string,\n\t\t\toptions?: CallOptions\n\t\t): Promise<BatchResultsResponse>;\n\t};\n\tforward(\n\t\tparams: ForwardGeocodeParams,\n\t\toptions?: CallOptions\n\t): Promise<ForwardGeocodeResponse>;\n}\n\nexport const createGeocode = (request: Requester): GeocodeResource => ({\n\tforward: (params, options) =>\n\t\trequest<ForwardGeocodeResponse>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: \"/api/v1/addresses/geocode\",\n\t\t\tquery: {\n\t\t\t\tq: params.q,\n\t\t\t\tstructured: params.structured,\n\t\t\t\tstreet: params.street,\n\t\t\t\tlocality: params.locality,\n\t\t\t\tstate: params.state,\n\t\t\t\tpostcode: params.postcode,\n\t\t\t\tcountry: params.country,\n\t\t\t},\n\t\t\t...options,\n\t\t}),\n\tbatch: {\n\t\tsubmit: (body, options) =>\n\t\t\trequest<BatchSubmitResponse>({\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tpath: \"/api/v1/geocode/batch\",\n\t\t\t\tbody,\n\t\t\t\t...options,\n\t\t\t}),\n\t\tpoll: (jobId, options) =>\n\t\t\trequest<BatchJobStatus>({\n\t\t\t\tmethod: \"GET\",\n\t\t\t\tpath: `/api/v1/geocode/batch/${jobId}`,\n\t\t\t\t...options,\n\t\t\t}),\n\t\tresults: (jobId, options) =>\n\t\t\trequest<BatchResultsResponse>({\n\t\t\t\tmethod: \"GET\",\n\t\t\t\tpath: `/api/v1/geocode/batch/${jobId}/results`,\n\t\t\t\t...options,\n\t\t\t}),\n\t},\n});\n","import type { CallOptions, Requester } from \"../shared-types.ts\";\n\nexport interface RegionsClassifyParams {\n\tlat: number;\n\tlayers?: string;\n\tlng: number;\n}\n\nexport interface RegionMatch {\n\tcode: string;\n\tname: string;\n}\n\nexport interface RegionsClassifyResponse {\n\tquery: { lat: number; lng: number };\n\tregions: Record<string, RegionMatch>;\n}\n\nexport interface RegionsResource {\n\tclassify(\n\t\tparams: RegionsClassifyParams,\n\t\toptions?: CallOptions\n\t): Promise<RegionsClassifyResponse>;\n}\n\nexport const createRegions = (request: Requester): RegionsResource => ({\n\tclassify: (params, options) =>\n\t\trequest<RegionsClassifyResponse>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: \"/api/v1/regions\",\n\t\t\tquery: { lat: params.lat, lng: params.lng, layers: params.layers },\n\t\t\t...options,\n\t\t}),\n});\n","import type { CallOptions, Requester } from \"../shared-types.ts\";\n\nexport interface DirectionsParams {\n\tfrom?: string;\n\tfromAddressId?: number;\n\tprofile?: \"driving\";\n\tto?: string;\n\ttoAddressId?: number;\n}\n\nexport interface DirectionsGeometry {\n\tcoordinates: [number, number][];\n\ttype: \"LineString\";\n}\n\nexport interface DirectionsResponse {\n\tdistance_m: number;\n\tduration_s: number;\n\tgeometry: DirectionsGeometry;\n\tquery: {\n\t\tfrom: { lat: number; lng: number };\n\t\tprofile: string;\n\t\tto: { lat: number; lng: number };\n\t};\n}\n\nexport interface RoutingResource {\n\tdirections(\n\t\tparams: DirectionsParams,\n\t\toptions?: CallOptions\n\t): Promise<DirectionsResponse>;\n}\n\nexport const createRouting = (request: Requester): RoutingResource => ({\n\tdirections: (params, options) =>\n\t\trequest<DirectionsResponse>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: \"/api/v1/routing/directions\",\n\t\t\tquery: {\n\t\t\t\tfrom: params.from,\n\t\t\t\tto: params.to,\n\t\t\t\tfromAddressId: params.fromAddressId,\n\t\t\t\ttoAddressId: params.toAddressId,\n\t\t\t\tprofile: params.profile,\n\t\t\t},\n\t\t\t...options,\n\t\t}),\n});\n","import type { CallOptions, Requester } from \"../shared-types.ts\";\n\nexport type WebhookEvent = \"entry\" | \"exit\";\n\nexport interface CreateWebhookBody {\n\tevents?: WebhookEvent[];\n\turl: string;\n\tzoneId?: number;\n}\n\nexport interface WebhookSubscription {\n\tactive: boolean;\n\tcreatedAt: string;\n\tevents: WebhookEvent[];\n\tid: number;\n\turl: string;\n\tzoneId: number | null;\n}\n\nexport interface CreateWebhookResponse extends WebhookSubscription {\n\tsecret: string;\n}\n\nexport interface WebhookListItem extends WebhookSubscription {\n\tfailing: boolean;\n}\n\nexport interface ListWebhooksResponse {\n\tcount: number;\n\tresults: WebhookListItem[];\n}\n\nexport interface DeleteWebhookResponse {\n\tdeleted: true;\n\tid: number;\n}\n\nexport interface ReactivateWebhookResponse {\n\tid: number;\n\treactivated: true;\n}\n\nexport interface WebhooksResource {\n\tcreate(\n\t\tbody: CreateWebhookBody,\n\t\toptions?: CallOptions\n\t): Promise<CreateWebhookResponse>;\n\tdelete(id: number, options?: CallOptions): Promise<DeleteWebhookResponse>;\n\tlist(options?: CallOptions): Promise<ListWebhooksResponse>;\n\treactivate(\n\t\tid: number,\n\t\toptions?: CallOptions\n\t): Promise<ReactivateWebhookResponse>;\n}\n\nexport const createWebhooks = (request: Requester): WebhooksResource => ({\n\tcreate: (body, options) =>\n\t\trequest<CreateWebhookResponse>({\n\t\t\tmethod: \"POST\",\n\t\t\tpath: \"/api/v1/webhooks\",\n\t\t\tbody,\n\t\t\t...options,\n\t\t}),\n\tlist: (options) =>\n\t\trequest<ListWebhooksResponse>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: \"/api/v1/webhooks\",\n\t\t\t...options,\n\t\t}),\n\tdelete: (id, options) =>\n\t\trequest<DeleteWebhookResponse>({\n\t\t\tmethod: \"DELETE\",\n\t\t\tpath: `/api/v1/webhooks/${id}`,\n\t\t\t...options,\n\t\t}),\n\treactivate: (id, options) =>\n\t\trequest<ReactivateWebhookResponse>({\n\t\t\tmethod: \"POST\",\n\t\t\tpath: `/api/v1/webhooks/${id}/reactivate`,\n\t\t\t...options,\n\t\t}),\n});\n","import type { CallOptions, Requester } from \"../shared-types.ts\";\n\n// --- Types ---\n\nexport interface ZoneRecord {\n\tcreatedAt: string;\n\tdescription: string | null;\n\tid: number;\n\tmetadata: Record<string, unknown> | null;\n\tname: string;\n\tprojectId: string;\n\tupdatedAt: string;\n}\n\nexport interface ZoneWithGeometry extends ZoneRecord {\n\tgeometry: {\n\t\ttype: string;\n\t\tcoordinates: number[][][];\n\t};\n}\n\n// --- GeoJSON Polygon geometry ---\n\nexport interface GeoJsonPolygon {\n\tcoordinates: number[][][];\n\ttype: \"Polygon\";\n}\n\n// --- Param interfaces ---\n\nexport interface ZoneListParams {\n\tlimit?: number;\n\tpage?: number;\n}\n\nexport interface ZoneContainsParams {\n\tlat: number;\n\tlng: number;\n}\n\nexport interface ZoneAddressesParams {\n\tlimit?: number;\n\tpage?: number;\n}\n\nexport interface ZoneCreateBody {\n\tdescription?: string;\n\tgeometry: GeoJsonPolygon;\n\tmetadata?: Record<string, unknown>;\n\tname: string;\n}\n\nexport interface ZoneUpdateBody {\n\tdescription?: string;\n\tgeometry?: GeoJsonPolygon;\n\tmetadata?: Record<string, unknown>;\n\tname?: string;\n}\n\n// --- Response interfaces ---\n\nexport interface ZoneListResponse {\n\tcount: number;\n\tpage: number;\n\tzones: ZoneRecord[];\n}\n\nexport interface ZoneDeleteResponse {\n\tsuccess: true;\n}\n\nexport interface ZoneContainsResponse {\n\tcount: number;\n\tquery: { lat: number; lng: number };\n\tzones: ZoneRecord[];\n}\n\nexport interface ZoneAddressesResponse {\n\tcount: number;\n\tquery: { id: number; limit: number; page: number };\n\tresults: Array<{\n\t\tbuildingName: string | null;\n\t\tcountry: string;\n\t\tflatNumber: string | null;\n\t\tflatType: string | null;\n\t\tid: number;\n\t\tlatitude: number;\n\t\tlocality: string;\n\t\tlongitude: number;\n\t\tnumberFirst: string | null;\n\t\tnumberLast: string | null;\n\t\tpostcode: string;\n\t\tstate: string;\n\t\tstreetName: string;\n\t\tstreetType: string | null;\n\t}>;\n\ttruncated: boolean;\n}\n\n// --- Resource interface ---\n\nexport interface ZonesResource {\n\taddresses(\n\t\tid: number,\n\t\tparams?: ZoneAddressesParams,\n\t\toptions?: CallOptions\n\t): Promise<ZoneAddressesResponse>;\n\tcontains(\n\t\tparams: ZoneContainsParams,\n\t\toptions?: CallOptions\n\t): Promise<ZoneContainsResponse>;\n\tcreate(body: ZoneCreateBody, options?: CallOptions): Promise<ZoneRecord>;\n\tdelete(id: number, options?: CallOptions): Promise<ZoneDeleteResponse>;\n\tget(id: number, options?: CallOptions): Promise<ZoneWithGeometry>;\n\tlist(\n\t\tparams?: ZoneListParams,\n\t\toptions?: CallOptions\n\t): Promise<ZoneListResponse>;\n\tupdate(\n\t\tid: number,\n\t\tbody: ZoneUpdateBody,\n\t\toptions?: CallOptions\n\t): Promise<ZoneRecord>;\n}\n\n// --- Factory ---\n\nexport const createZones = (request: Requester): ZonesResource => ({\n\tcreate: (body, options) =>\n\t\trequest<ZoneRecord>({\n\t\t\tmethod: \"POST\",\n\t\t\tpath: \"/api/v1/zones\",\n\t\t\tbody,\n\t\t\t...options,\n\t\t}),\n\n\tlist: (params, options) =>\n\t\trequest<ZoneListResponse>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: \"/api/v1/zones\",\n\t\t\tquery: { page: params?.page, limit: params?.limit },\n\t\t\t...options,\n\t\t}),\n\n\tget: (id, options) =>\n\t\trequest<ZoneWithGeometry>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: `/api/v1/zones/${id}`,\n\t\t\t...options,\n\t\t}),\n\n\tupdate: (id, body, options) =>\n\t\trequest<ZoneRecord>({\n\t\t\tmethod: \"PUT\",\n\t\t\tpath: `/api/v1/zones/${id}`,\n\t\t\tbody,\n\t\t\t...options,\n\t\t}),\n\n\tdelete: (id, options) =>\n\t\trequest<ZoneDeleteResponse>({\n\t\t\tmethod: \"DELETE\",\n\t\t\tpath: `/api/v1/zones/${id}`,\n\t\t\t...options,\n\t\t}),\n\n\tcontains: (params, options) =>\n\t\trequest<ZoneContainsResponse>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: \"/api/v1/zones/contains\",\n\t\t\tquery: { lat: params.lat, lng: params.lng },\n\t\t\t...options,\n\t\t}),\n\n\taddresses: (id, params, options) =>\n\t\trequest<ZoneAddressesResponse>({\n\t\t\tmethod: \"GET\",\n\t\t\tpath: `/api/v1/zones/${id}/addresses`,\n\t\t\tquery: { page: params?.page, limit: params?.limit },\n\t\t\t...options,\n\t\t}),\n});\n","import { createRequester } from \"./http.ts\";\nimport {\n\ttype AddressesResource,\n\tcreateAddresses,\n} from \"./resources/addresses.ts\";\nimport { createDevices, type DevicesResource } from \"./resources/devices.ts\";\nimport { createGeocode, type GeocodeResource } from \"./resources/geocode.ts\";\nimport { createRegions, type RegionsResource } from \"./resources/regions.ts\";\nimport { createRouting, type RoutingResource } from \"./resources/routing.ts\";\nimport { createWebhooks, type WebhooksResource } from \"./resources/webhooks.ts\";\nimport { createZones, type ZonesResource } from \"./resources/zones.ts\";\nimport type { WheraboutsClientConfig } from \"./shared-types.ts\";\n\nexport interface WheraboutsClient {\n\taddresses: AddressesResource;\n\tdevices: DevicesResource;\n\tgeocode: GeocodeResource;\n\tregions: RegionsResource;\n\trouting: RoutingResource;\n\twebhooks: WebhooksResource;\n\tzones: ZonesResource;\n}\n\nexport const createWheraboutsClient = (\n\tconfig: WheraboutsClientConfig\n): WheraboutsClient => {\n\tconst request = createRequester(config);\n\treturn {\n\t\taddresses: createAddresses(request),\n\t\tgeocode: createGeocode(request),\n\t\tzones: createZones(request),\n\t\tdevices: createDevices(request),\n\t\twebhooks: createWebhooks(request),\n\t\tregions: createRegions(request),\n\t\trouting: createRouting(request),\n\t};\n};\n"]}

package/dist/index.d.cts

@@ -0,0 +1,480 @@
+declare const WHERABOUTS_API_VERSION: "v1";
+declare const WHERABOUTS_SDK_VERSION: "0.2.0";
+/**
+ * Error codes the API may return. The server currently emits a subset; the full
+ * union is declared for forward-compatibility with the Phase 2 error envelope
+ * (see docs/CONTRACT.md §4). Unknown codes fall back to `unknown_error`.
+ */
+type WheraboutsErrorCode = "bad_request" | "conflict" | "forbidden" | "internal_error" | "not_found" | "rate_limited" | "timeout" | "unauthorized" | "unprocessable";
+interface WheraboutsFieldError {
+    message: string;
+    path: string;
+}
+interface WheraboutsApiErrorPayload {
+    error: {
+        code: WheraboutsErrorCode;
+        message: string;
+        /** Correlation id; also sent as the `X-Request-Id` response header. */
+        request_id?: string;
+        /** Link to documentation for this error code. */
+        doc_url?: string;
+        /** Field-level validation detail (validation errors only). */
+        fields?: WheraboutsFieldError[];
+    };
+}
+interface WheraboutsClientConfig {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    headers?: Record<string, string>;
+    /** Max automatic retries for transient failures. Default 2. */
+    maxRetries?: number;
+    /** Per-request timeout in milliseconds. Default 30000. */
+    timeoutMs?: number;
+}
+/**
+ * Per-call overrides. Every resource method accepts an optional trailing
+ * `options` argument of this shape.
+ */
+interface CallOptions {
+    /** Extra headers merged over (not replacing) the client headers. */
+    headers?: Record<string, string>;
+    /** Idempotency key for write requests. Auto-generated on writes if omitted. */
+    idempotencyKey?: string;
+    /** Override the client's `maxRetries` for this call. */
+    maxRetries?: number;
+    /** Abort signal — aborting rejects the call (and is not retried). */
+    signal?: AbortSignal;
+    /** Override the client's `timeoutMs` for this call. */
+    timeoutMs?: number;
+}
+type HttpMethod = "GET" | "POST" | "PUT" | "DELETE";
+interface RequestOptions extends CallOptions {
+    body?: unknown;
+    method: HttpMethod;
+    path: string;
+    query?: Record<string, number | string | undefined>;
+}
+type Requester = <T>(opts: RequestOptions) => Promise<T>;
+
+interface AddressSuggestion {
+    country: string;
+    formattedAddress: string;
+    id: number;
+    latitude: number;
+    locality: string;
+    longitude: number;
+    postcode: string;
+    state: string;
+    streetAddress: string;
+}
+interface AddressRecord {
+    buildingName: string | null;
+    confidence: number | null;
+    country: string;
+    flatNumber: string | null;
+    flatType: string | null;
+    gnafPid: string | null;
+    id: number;
+    latitude: number;
+    levelNumber: string | null;
+    levelType: string | null;
+    locality: string;
+    longitude: number;
+    numberFirst: string | null;
+    numberLast: string | null;
+    postcode: string;
+    state: string;
+    streetName: string;
+    streetSuffix: string | null;
+    streetType: string | null;
+}
+interface NearbyAddress {
+    buildingName: string | null;
+    country: string;
+    distance: number;
+    flatNumber: string | null;
+    flatType: string | null;
+    id: number;
+    latitude: number;
+    locality: string;
+    longitude: number;
+    numberFirst: string | null;
+    numberLast: string | null;
+    postcode: string;
+    state: string;
+    streetName: string;
+    streetType: string | null;
+}
+interface ReverseGeocodeAddress {
+    confidence: number | null;
+    country: string;
+    formattedAddress: string;
+    id: number;
+    latitude: number;
+    locality: string;
+    longitude: number;
+    postcode: string;
+    state: string;
+    streetAddress: string;
+}
+interface AutocompleteParams {
+    country?: string;
+    limit?: number;
+    q: string;
+    state?: string;
+}
+interface NearbyParams {
+    country?: string;
+    lat: number;
+    limit?: number;
+    lng: number;
+    radius?: number;
+}
+interface ReverseParams {
+    lat: number;
+    lng: number;
+}
+interface AutocompleteResponse {
+    count: number;
+    results: AddressSuggestion[];
+}
+interface NearbyResponse {
+    count: number;
+    query: {
+        lat: number;
+        lng: number;
+        radius: number;
+    };
+    results: NearbyAddress[];
+}
+interface ReverseResponse {
+    address: ReverseGeocodeAddress;
+    distance: number;
+    query: {
+        lat: number;
+        lng: number;
+    };
+}
+interface AddressesResource {
+    autocomplete(params: AutocompleteParams, options?: CallOptions): Promise<AutocompleteResponse>;
+    getById(id: number, options?: CallOptions): Promise<AddressRecord>;
+    nearby(params: NearbyParams, options?: CallOptions): Promise<NearbyResponse>;
+    reverse(params: ReverseParams, options?: CallOptions): Promise<ReverseResponse>;
+}
+declare const createAddresses: (request: Requester) => AddressesResource;
+
+interface BoundaryCrossing {
+    event: "entry" | "exit";
+    zoneId: number;
+    zoneName: string;
+}
+interface PushLocationBody {
+    lat: number;
+    lng: number;
+}
+interface PushLocationResponse {
+    crossings: BoundaryCrossing[];
+    zones: number[];
+}
+interface DeviceZonesResponse {
+    deviceId: string;
+    latitude: number | null;
+    longitude: number | null;
+    updatedAt: string | null;
+    zoneIds: number[];
+}
+interface DevicesResource {
+    pushLocation(deviceId: string, body: PushLocationBody, options?: CallOptions): Promise<PushLocationResponse>;
+    zones(deviceId: string, options?: CallOptions): Promise<DeviceZonesResponse>;
+}
+declare const createDevices: (request: Requester) => DevicesResource;
+
+/**
+ * Params for forward geocoding. Provide `q` for unstructured free-text search,
+ * OR `street` + `locality` (plus optional `state`, `postcode`, `country`) for
+ * structured mode. Set `structured: "true"` when using structured fields.
+ */
+interface ForwardGeocodeParams {
+    /** ISO 3166-1 alpha-2 country code, e.g. "AU". */
+    country?: string;
+    /** Suburb / locality (structured mode). */
+    locality?: string;
+    /** Postcode / ZIP. */
+    postcode?: string;
+    /** Free-text address query (unstructured mode). */
+    q?: string;
+    /** State abbreviation, e.g. "NSW". */
+    state?: string;
+    /** Street address (structured mode). */
+    street?: string;
+    /** Pass `"true"` to enable structured mode. */
+    structured?: "true" | "false";
+}
+interface GeocodeAddress {
+    country: string;
+    formattedAddress: string;
+    id: number;
+    latitude: number;
+    locality: string;
+    longitude: number;
+    postcode: string;
+    state: string;
+    streetAddress: string;
+}
+interface ForwardGeocodeResponse {
+    address: GeocodeAddress;
+    matchType: "structured" | "fuzzy";
+}
+interface BatchSubmitBody {
+    addresses: string[];
+}
+interface BatchSubmitResponse {
+    inputCount: number;
+    jobId: string;
+    status: "pending" | "processing";
+}
+interface BatchJobStatus {
+    completedAt: string | null;
+    downloadUrl: string | null;
+    error: string | null;
+    inputCount: number;
+    jobId: string;
+    processedCount: number | null;
+    status: "pending" | "processing" | "completed" | "failed";
+}
+interface BatchResultsResponse {
+    count: number;
+    results: unknown[];
+}
+interface GeocodeResource {
+    batch: {
+        submit(body: BatchSubmitBody, options?: CallOptions): Promise<BatchSubmitResponse>;
+        poll(jobId: string, options?: CallOptions): Promise<BatchJobStatus>;
+        results(jobId: string, options?: CallOptions): Promise<BatchResultsResponse>;
+    };
+    forward(params: ForwardGeocodeParams, options?: CallOptions): Promise<ForwardGeocodeResponse>;
+}
+declare const createGeocode: (request: Requester) => GeocodeResource;
+
+interface RegionsClassifyParams {
+    lat: number;
+    layers?: string;
+    lng: number;
+}
+interface RegionMatch {
+    code: string;
+    name: string;
+}
+interface RegionsClassifyResponse {
+    query: {
+        lat: number;
+        lng: number;
+    };
+    regions: Record<string, RegionMatch>;
+}
+interface RegionsResource {
+    classify(params: RegionsClassifyParams, options?: CallOptions): Promise<RegionsClassifyResponse>;
+}
+declare const createRegions: (request: Requester) => RegionsResource;
+
+interface DirectionsParams {
+    from?: string;
+    fromAddressId?: number;
+    profile?: "driving";
+    to?: string;
+    toAddressId?: number;
+}
+interface DirectionsGeometry {
+    coordinates: [number, number][];
+    type: "LineString";
+}
+interface DirectionsResponse {
+    distance_m: number;
+    duration_s: number;
+    geometry: DirectionsGeometry;
+    query: {
+        from: {
+            lat: number;
+            lng: number;
+        };
+        profile: string;
+        to: {
+            lat: number;
+            lng: number;
+        };
+    };
+}
+interface RoutingResource {
+    directions(params: DirectionsParams, options?: CallOptions): Promise<DirectionsResponse>;
+}
+declare const createRouting: (request: Requester) => RoutingResource;
+
+type WebhookEvent = "entry" | "exit";
+interface CreateWebhookBody {
+    events?: WebhookEvent[];
+    url: string;
+    zoneId?: number;
+}
+interface WebhookSubscription {
+    active: boolean;
+    createdAt: string;
+    events: WebhookEvent[];
+    id: number;
+    url: string;
+    zoneId: number | null;
+}
+interface CreateWebhookResponse extends WebhookSubscription {
+    secret: string;
+}
+interface WebhookListItem extends WebhookSubscription {
+    failing: boolean;
+}
+interface ListWebhooksResponse {
+    count: number;
+    results: WebhookListItem[];
+}
+interface DeleteWebhookResponse {
+    deleted: true;
+    id: number;
+}
+interface ReactivateWebhookResponse {
+    id: number;
+    reactivated: true;
+}
+interface WebhooksResource {
+    create(body: CreateWebhookBody, options?: CallOptions): Promise<CreateWebhookResponse>;
+    delete(id: number, options?: CallOptions): Promise<DeleteWebhookResponse>;
+    list(options?: CallOptions): Promise<ListWebhooksResponse>;
+    reactivate(id: number, options?: CallOptions): Promise<ReactivateWebhookResponse>;
+}
+declare const createWebhooks: (request: Requester) => WebhooksResource;
+
+interface ZoneRecord {
+    createdAt: string;
+    description: string | null;
+    id: number;
+    metadata: Record<string, unknown> | null;
+    name: string;
+    projectId: string;
+    updatedAt: string;
+}
+interface ZoneWithGeometry extends ZoneRecord {
+    geometry: {
+        type: string;
+        coordinates: number[][][];
+    };
+}
+interface GeoJsonPolygon {
+    coordinates: number[][][];
+    type: "Polygon";
+}
+interface ZoneListParams {
+    limit?: number;
+    page?: number;
+}
+interface ZoneContainsParams {
+    lat: number;
+    lng: number;
+}
+interface ZoneAddressesParams {
+    limit?: number;
+    page?: number;
+}
+interface ZoneCreateBody {
+    description?: string;
+    geometry: GeoJsonPolygon;
+    metadata?: Record<string, unknown>;
+    name: string;
+}
+interface ZoneUpdateBody {
+    description?: string;
+    geometry?: GeoJsonPolygon;
+    metadata?: Record<string, unknown>;
+    name?: string;
+}
+interface ZoneListResponse {
+    count: number;
+    page: number;
+    zones: ZoneRecord[];
+}
+interface ZoneDeleteResponse {
+    success: true;
+}
+interface ZoneContainsResponse {
+    count: number;
+    query: {
+        lat: number;
+        lng: number;
+    };
+    zones: ZoneRecord[];
+}
+interface ZoneAddressesResponse {
+    count: number;
+    query: {
+        id: number;
+        limit: number;
+        page: number;
+    };
+    results: Array<{
+        buildingName: string | null;
+        country: string;
+        flatNumber: string | null;
+        flatType: string | null;
+        id: number;
+        latitude: number;
+        locality: string;
+        longitude: number;
+        numberFirst: string | null;
+        numberLast: string | null;
+        postcode: string;
+        state: string;
+        streetName: string;
+        streetType: string | null;
+    }>;
+    truncated: boolean;
+}
+interface ZonesResource {
+    addresses(id: number, params?: ZoneAddressesParams, options?: CallOptions): Promise<ZoneAddressesResponse>;
+    contains(params: ZoneContainsParams, options?: CallOptions): Promise<ZoneContainsResponse>;
+    create(body: ZoneCreateBody, options?: CallOptions): Promise<ZoneRecord>;
+    delete(id: number, options?: CallOptions): Promise<ZoneDeleteResponse>;
+    get(id: number, options?: CallOptions): Promise<ZoneWithGeometry>;
+    list(params?: ZoneListParams, options?: CallOptions): Promise<ZoneListResponse>;
+    update(id: number, body: ZoneUpdateBody, options?: CallOptions): Promise<ZoneRecord>;
+}
+declare const createZones: (request: Requester) => ZonesResource;
+
+interface WheraboutsClient {
+    addresses: AddressesResource;
+    devices: DevicesResource;
+    geocode: GeocodeResource;
+    regions: RegionsResource;
+    routing: RoutingResource;
+    webhooks: WebhooksResource;
+    zones: ZonesResource;
+}
+declare const createWheraboutsClient: (config: WheraboutsClientConfig) => WheraboutsClient;
+
+declare class WheraboutsApiError extends Error {
+    readonly code: WheraboutsErrorCode | "unknown_error";
+    readonly payload: WheraboutsApiErrorPayload | null;
+    readonly status: number;
+    /** Correlation id from the `X-Request-Id` header or error body, if present. */
+    readonly requestId: string | null;
+    /** Documentation link for this error, if the API provided one. */
+    readonly docUrl: string | null;
+    /** Field-level validation detail, if the API provided any. */
+    readonly fields: WheraboutsFieldError[] | null;
+    constructor(options: {
+        code?: WheraboutsApiError["code"];
+        docUrl?: string | null;
+        fields?: WheraboutsFieldError[] | null;
+        message: string;
+        payload?: WheraboutsApiErrorPayload | null;
+        requestId?: string | null;
+        status: number;
+    });
+}
+
+export { type AddressRecord, type AddressSuggestion, type AddressesResource, type AutocompleteParams, type AutocompleteResponse, type BatchJobStatus, type BatchResultsResponse, type BatchSubmitBody, type BatchSubmitResponse, type BoundaryCrossing, type CallOptions, type CreateWebhookBody, type CreateWebhookResponse, type DeleteWebhookResponse, type DeviceZonesResponse, type DevicesResource, type DirectionsGeometry, type DirectionsParams, type DirectionsResponse, type ForwardGeocodeParams, type ForwardGeocodeResponse, type GeoJsonPolygon, type GeocodeAddress, type GeocodeResource, type ListWebhooksResponse, type NearbyAddress, type NearbyParams, type NearbyResponse, type PushLocationBody, type PushLocationResponse, type ReactivateWebhookResponse, type RegionMatch, type RegionsClassifyParams, type RegionsClassifyResponse, type RegionsResource, type ReverseGeocodeAddress, type ReverseParams, type ReverseResponse, type RoutingResource, WHERABOUTS_API_VERSION, WHERABOUTS_SDK_VERSION, type WebhookEvent, type WebhookListItem, type WebhookSubscription, type WebhooksResource, WheraboutsApiError, type WheraboutsApiErrorPayload, type WheraboutsClient, type WheraboutsClientConfig, type WheraboutsErrorCode, type WheraboutsFieldError, type ZoneAddressesParams, type ZoneAddressesResponse, type ZoneContainsParams, type ZoneContainsResponse, type ZoneCreateBody, type ZoneDeleteResponse, type ZoneListParams, type ZoneListResponse, type ZoneRecord, type ZoneUpdateBody, type ZoneWithGeometry, type ZonesResource, createAddresses, createDevices, createGeocode, createRegions, createRouting, createWebhooks, createWheraboutsClient, createZones };