@parseapi/sdk 1.12.4 → 1.12.5

package/README.md

@@ -189,8 +189,8 @@ await parse.date.today();
 await parse.holiday('US', { year: 2026 });
 await parse.holiday.date('US', '2026-12-25');
 await parse.elevation(35.2271, -80.8431);
-await parse.elevation.points([[35.2271, -80.8431], [40.7128, -74.006]]);
-await parse.elevation.path([[35.2271, -80.8431], [35.5951, -82.5515]], 100);
+await parse.elevation.points([[39.7392, -104.9903], [39.75, -104.98]]);
+await parse.elevation.path([[39.7392, -104.9903], [39.75, -104.98]], 100);
 await parse.point(36.0726, -79.792);
 await parse.weather(40.7128, -74.006);
 await parse.domain('example.com');
@@ -215,9 +215,11 @@ DNS uses pooled requests on every plan. Omit `type` to check A, AAAA, CNAME, MX,
 
 ## Elevation
 
-`elevation(lat, lon)` returns one sample with meters, feet and grid resolution in meters. `elevation.points(...)` accepts up to 512 `[lat, lon]` pairs, a `lat,lon|lat,lon` string, or `enc:` followed by a Google encoded polyline. Its `points` array preserves input order and duplicate coordinates. Unknown samples stay null, and negative elevations and known zero values are preserved. Each list uses one pooled request. The SDK automatically uses JSON POST for long URLs and numeric coordinates that JavaScript expresses in exponent notation.
+`elevation(lat, lon)` returns one sample with meters, feet and grid resolution in meters. `elevation.points(...)` accepts up to 512 points per local batch as `[lat, lon]` pairs, a `lat,lon|lat,lon` string, or `enc:` followed by a Google encoded polyline. Its `points` array preserves input order and duplicate coordinates. Unknown samples stay null, and negative elevations and known zero values are preserved. Each accepted local list uses one pooled request. The SDK automatically uses JSON POST for long URLs and numeric coordinates that JavaScript expresses in exponent notation.
 
-`elevation.path(path, samples)` accepts the same input formats with 2-512 path vertices and a required integer sample count from 2 to 512. Its `points` array includes both endpoints, with samples spaced uniformly by cumulative great-circle distance along the path. Each segment follows the shortest arc. A segment with antipodal endpoints is rejected because it does not define a unique arc. Path sampling uses one pooled request and automatically selects JSON POST for a long URL.
+`elevation.path(path, samples)` accepts the same input formats with 2-512 path vertices and a required integer sample count from 2 to 512. Its `points` array includes both endpoints, with samples spaced uniformly by cumulative great-circle distance along the path. Each segment follows the shortest arc. A segment with antipodal endpoints is rejected because it does not define a unique arc. Each accepted local path uses one pooled request and automatically selects JSON POST for a long URL.
+
+Each local batch is limited to 25 km between any two coordinates and 12 distinct terrain files in total across the fine grid and all possible global fallback files. For paths, both the supplied vertices and generated samples must fit the 25 km span. The terrain file budget applies to the sampled coordinates. This is a span limit, not a limit on cumulative path length. Send longer or more spread-out routes in shorter sections. An over-limit batch returns HTTP 400. GET, POST and polylines use the same limits. The SDK does not silently split or discard coordinates.
 
 ## Time
 
@@ -412,10 +414,10 @@ console.log(basic.at, detail.deep?.next_dst);
 
 ## Domain results with unknown availability
 
-Use `domainResult` when deciding whether a domain is registered. It returns `available: true` for unregistered, `false` for registered, and `null` when the registry answer is unknown.
+Use `domain` when deciding whether a domain is registered. It returns `available: true` for unregistered, `false` for registered, and `null` when the registry answer is unknown.
 
 ```ts
-const result = await parse.domainResult('example.com', { deep: true });
+const result = await parse.domain('example.com', { deep: true });
 if (result.available === null) {
   console.log('Registration could not be determined');
 } else {
@@ -425,7 +427,7 @@ if (result.available === null) {
 
 This makes one ordinary Domain lookup with the same options, authentication and retry policy. Registration detail may be partial. Missing or null `dnssec` is unknown, while `false` is a known negative. Missing or null `status` is unknown, while `[]` is a known empty list.
 
-The existing `domain` method and `Domain` type keep their published interface. That older type declares `available` as a boolean even though the API can return null. Use `domainResult` for its accurate nullable type.
+The ordinary `Domain` type represents unknown availability as `null`. The existing `domainResult` method and its result type remain available.
 
 ## Stack API
 

package/dist/index.cjs

@@ -448,7 +448,7 @@ var EmojiCatalog = class {
 };
 
 // src/index.ts
-var VERSION = "1.12.4";
+var VERSION = "1.12.5";
 var API_VERSION = "2.0.0";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;
@@ -752,7 +752,7 @@ function parseAPI(apiKey, options = {}) {
     hlr: (number, opts) => request(`/hlr/${enc(number)}`, { country: opts?.country, ...deepQuery(opts) }, void 0, opts),
     /** Identify website technologies by category, with homepage or bounded site coverage metadata. */
     stack: (domain, opts) => request(`/stack/${enc(domain)}`, { ...deepQuery(opts), pretty: opts?.pretty }, void 0, opts),
-    /** Check whether a domain is registered. Deep adds registration dates, registrar, status and DNSSEC on paid plans. */
+    /** Check registration: available is true, false or null when unknown. Paid Deep adds available registration details. */
     domain: (domain, opts) => request(`/domain/${enc(domain)}`, deepQuery(opts), void 0, opts),
     /** Check domain registration while preserving unknown availability and partial detail. */
     domainResult: (domain, opts) => request(`/domain/${enc(domain)}`, deepQuery(opts), void 0, opts),

package/dist/index.d.cts

@@ -368,19 +368,21 @@ interface Stack {
 }
 interface DomainRegistration {
     registered: boolean;
-    created: string | null;
-    updated: string | null;
-    expires: string | null;
-    registrar: string | null;
-    status: string[];
-    dnssec: boolean;
+    created?: string | null;
+    updated?: string | null;
+    expires?: string | null;
+    registrar?: string | null;
+    status?: string[] | null;
+    /** Missing or null is unknown; false is a known unsigned observation. */
+    dnssec?: boolean | null;
 }
 interface DomainDeep {
     registration: DomainRegistration;
 }
 interface Domain {
     domain: string;
-    available: boolean;
+    /** true means unregistered, false means registered, null means unknown. */
+    available: boolean | null;
     deep?: Deep<DomainDeep>;
 }
 /** Network identity for an autonomous system number. */
@@ -2279,7 +2281,7 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
     hlr: (number: string, opts?: HlrOptions) => Promise<Hlr>;
     /** Identify website technologies by category, with homepage or bounded site coverage metadata. */
     stack: (domain: string, opts?: StackOptions) => Promise<Stack>;
-    /** Check whether a domain is registered. Deep adds registration dates, registrar, status and DNSSEC on paid plans. */
+    /** Check registration: available is true, false or null when unknown. Paid Deep adds available registration details. */
     domain: (domain: string, opts?: DomainOptions) => Promise<Domain>;
     /** Check domain registration while preserving unknown availability and partial detail. */
     domainResult: (domain: string, opts?: DomainOptions) => Promise<DomainResult>;

package/dist/index.d.ts

@@ -368,19 +368,21 @@ interface Stack {
 }
 interface DomainRegistration {
     registered: boolean;
-    created: string | null;
-    updated: string | null;
-    expires: string | null;
-    registrar: string | null;
-    status: string[];
-    dnssec: boolean;
+    created?: string | null;
+    updated?: string | null;
+    expires?: string | null;
+    registrar?: string | null;
+    status?: string[] | null;
+    /** Missing or null is unknown; false is a known unsigned observation. */
+    dnssec?: boolean | null;
 }
 interface DomainDeep {
     registration: DomainRegistration;
 }
 interface Domain {
     domain: string;
-    available: boolean;
+    /** true means unregistered, false means registered, null means unknown. */
+    available: boolean | null;
     deep?: Deep<DomainDeep>;
 }
 /** Network identity for an autonomous system number. */
@@ -2279,7 +2281,7 @@ declare function parseAPI(apiKey?: string, options?: ParseAPIOptions): {
     hlr: (number: string, opts?: HlrOptions) => Promise<Hlr>;
     /** Identify website technologies by category, with homepage or bounded site coverage metadata. */
     stack: (domain: string, opts?: StackOptions) => Promise<Stack>;
-    /** Check whether a domain is registered. Deep adds registration dates, registrar, status and DNSSEC on paid plans. */
+    /** Check registration: available is true, false or null when unknown. Paid Deep adds available registration details. */
     domain: (domain: string, opts?: DomainOptions) => Promise<Domain>;
     /** Check domain registration while preserving unknown availability and partial detail. */
     domainResult: (domain: string, opts?: DomainOptions) => Promise<DomainResult>;

package/dist/index.js

@@ -416,7 +416,7 @@ var EmojiCatalog = class {
 };
 
 // src/index.ts
-var VERSION = "1.12.4";
+var VERSION = "1.12.5";
 var API_VERSION = "2.0.0";
 var DEFAULT_BASE_URL = "https://api.parseapi.com";
 var DEFAULT_TIMEOUT_MS = 1e4;
@@ -720,7 +720,7 @@ function parseAPI(apiKey, options = {}) {
     hlr: (number, opts) => request(`/hlr/${enc(number)}`, { country: opts?.country, ...deepQuery(opts) }, void 0, opts),
     /** Identify website technologies by category, with homepage or bounded site coverage metadata. */
     stack: (domain, opts) => request(`/stack/${enc(domain)}`, { ...deepQuery(opts), pretty: opts?.pretty }, void 0, opts),
-    /** Check whether a domain is registered. Deep adds registration dates, registrar, status and DNSSEC on paid plans. */
+    /** Check registration: available is true, false or null when unknown. Paid Deep adds available registration details. */
     domain: (domain, opts) => request(`/domain/${enc(domain)}`, deepQuery(opts), void 0, opts),
     /** Check domain registration while preserving unknown availability and partial detail. */
     domainResult: (domain, opts) => request(`/domain/${enc(domain)}`, deepQuery(opts), void 0, opts),

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@parseapi/sdk",
-	"version": "1.12.4",
+	"version": "1.12.5",
 	"description": "Official ParseAPI client for Node and TypeScript. One key, minimal JSON, fast.",
 	"keywords": [
 		"parseapi",