@samsarahq/samsara 13.28.0 → 13.29.0

package/dist/cjs/BaseClient.js

@@ -44,8 +44,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@samsarahq/samsara",
-        "X-Fern-SDK-Version": "13.28.0",
-        "User-Agent": "@samsarahq/samsara/13.28.0",
+        "X-Fern-SDK-Version": "13.29.0",
+        "User-Agent": "@samsarahq/samsara/13.29.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "X-Samsara-Version": (_a = options === null || options === void 0 ? void 0 : options.version) !== null && _a !== void 0 ? _a : "2025-06-11",

package/dist/cjs/api/resources/betaApIs/client/Client.d.ts

@@ -1648,6 +1648,36 @@ export declare class BetaApIsClient {
      */
     getPlaceDeletions(request?: Samsara.GetPlaceDeletionsRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.PlacesGetPlaceDeletionsResponseBody>;
     private __getPlaceDeletions;
+    /**
+     * Forward-geocodes a free-form address string. Does not create or update a Place. Returns geocode candidates with cursor pagination.
+     *
+     *  <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Read Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.GetPlaceGeocodeRequest} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.getPlaceGeocode({
+     *         address: "address"
+     *     })
+     */
+    getPlaceGeocode(request: Samsara.GetPlaceGeocodeRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.PlacesGetPlaceGeocodeResponseBody>;
+    private __getPlaceGeocode;
     /**
      * List all preferred fuel stations for your organization.
      *

package/dist/cjs/api/resources/betaApIs/client/Client.js

@@ -4858,6 +4858,96 @@ class BetaApIsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/places/deletions");
         });
     }
+    /**
+     * Forward-geocodes a free-form address string. Does not create or update a Place. Returns geocode candidates with cursor pagination.
+     *
+     *  <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Read Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.GetPlaceGeocodeRequest} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.getPlaceGeocode({
+     *         address: "address"
+     *     })
+     */
+    getPlaceGeocode(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getPlaceGeocode(request, requestOptions));
+    }
+    __getPlaceGeocode(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { address, after, limit } = request;
+            const _queryParams = {
+                address,
+                after,
+                limit,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "X-Samsara-Version": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.version }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.SamsaraEnvironment.ProductionApi, "places/geocode"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Samsara.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Samsara.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 405:
+                        throw new Samsara.MethodNotAllowedError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Samsara.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Samsara.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Samsara.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new Samsara.BadGatewayError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new Samsara.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    case 504:
+                        throw new Samsara.GatewayTimeoutError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.SamsaraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/places/geocode");
+        });
+    }
     /**
      * List all preferred fuel stations for your organization.
      *

package/dist/cjs/api/resources/betaApIs/client/requests/GetPlaceGeocodeRequest.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @example
+ *     {
+ *         address: "address"
+ *     }
+ */
+export interface GetPlaceGeocodeRequest {
+    /** Address string to forward-geocode (URL-encoded). Required; must be non-empty. */
+    address: string;
+    /**  If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results. */
+    after?: string;
+    /** The limit for how many objects will be in the response. Default 5, max 20. */
+    limit?: number;
+}

package/dist/cjs/api/resources/betaApIs/client/requests/GetPlaceGeocodeRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/betaApIs/client/requests/index.d.ts

@@ -33,6 +33,7 @@ export type { GetFunctionStorageFileRequest } from "./GetFunctionStorageFileRequ
 export type { GetHosEldEventsRequest } from "./GetHosEldEventsRequest.js";
 export type { GetJobsRequest } from "./GetJobsRequest.js";
 export type { GetPlaceDeletionsRequest } from "./GetPlaceDeletionsRequest.js";
+export type { GetPlaceGeocodeRequest } from "./GetPlaceGeocodeRequest.js";
 export type { GetPlacesRequest } from "./GetPlacesRequest.js";
 export type { GetPreferredStationRequest } from "./GetPreferredStationRequest.js";
 export type { GetQualificationRecordsRequest } from "./GetQualificationRecordsRequest.js";

package/dist/cjs/api/types/PlaceGeocodeResultResponseResponseBody.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A forward-geocode candidate for an address.
+ */
+export interface PlaceGeocodeResultResponseResponseBody {
+    /** Latitude in WGS84 decimal degrees. */
+    latitude: number;
+    /** Longitude in WGS84 decimal degrees. */
+    longitude: number;
+}

package/dist/cjs/api/types/PlaceGeocodeResultResponseResponseBody.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/PlacesGetPlaceGeocodeBadGatewayErrorResponseBody.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Bad Gateway
+ */
+export interface PlacesGetPlaceGeocodeBadGatewayErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/cjs/api/types/PlacesGetPlaceGeocodeBadGatewayErrorResponseBody.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/PlacesGetPlaceGeocodeGatewayTimeoutErrorResponseBody.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Gateway timeout
+ */
+export interface PlacesGetPlaceGeocodeGatewayTimeoutErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/cjs/api/types/PlacesGetPlaceGeocodeGatewayTimeoutErrorResponseBody.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/PlacesGetPlaceGeocodeInternalServerErrorResponseBody.d.ts

@@ -0,0 +1,9 @@
+/**
+ * An internal server error occurred
+ */
+export interface PlacesGetPlaceGeocodeInternalServerErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/cjs/api/types/PlacesGetPlaceGeocodeInternalServerErrorResponseBody.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/PlacesGetPlaceGeocodeMethodNotAllowedErrorResponseBody.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Method not allowed
+ */
+export interface PlacesGetPlaceGeocodeMethodNotAllowedErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/cjs/api/types/PlacesGetPlaceGeocodeMethodNotAllowedErrorResponseBody.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/PlacesGetPlaceGeocodeNotFoundErrorResponseBody.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resource not found
+ */
+export interface PlacesGetPlaceGeocodeNotFoundErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/cjs/api/types/PlacesGetPlaceGeocodeNotFoundErrorResponseBody.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/PlacesGetPlaceGeocodeNotImplementedErrorResponseBody.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Requested endpoint is not yet implemented
+ */
+export interface PlacesGetPlaceGeocodeNotImplementedErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/cjs/api/types/PlacesGetPlaceGeocodeNotImplementedErrorResponseBody.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/PlacesGetPlaceGeocodeResponseBody.d.ts

@@ -0,0 +1,6 @@
+import type * as Samsara from "../index.js";
+export interface PlacesGetPlaceGeocodeResponseBody {
+    /** Geocode candidates for the requested address. */
+    data: Samsara.PlaceGeocodeResultResponseResponseBody[];
+    pagination: Samsara.GoaPaginationResponseResponseBody;
+}

package/dist/cjs/api/types/PlacesGetPlaceGeocodeResponseBody.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/PlacesGetPlaceGeocodeServiceUnavailableErrorResponseBody.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Service unavailable
+ */
+export interface PlacesGetPlaceGeocodeServiceUnavailableErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/cjs/api/types/PlacesGetPlaceGeocodeServiceUnavailableErrorResponseBody.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/PlacesGetPlaceGeocodeTooManyRequestsErrorResponseBody.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Too many requests
+ */
+export interface PlacesGetPlaceGeocodeTooManyRequestsErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/cjs/api/types/PlacesGetPlaceGeocodeTooManyRequestsErrorResponseBody.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/PlacesGetPlaceGeocodeUnauthorizedErrorResponseBody.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Unauthorized
+ */
+export interface PlacesGetPlaceGeocodeUnauthorizedErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/cjs/api/types/PlacesGetPlaceGeocodeUnauthorizedErrorResponseBody.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/index.d.ts

@@ -1970,6 +1970,7 @@ export * from "./PersonDetectedResponseBody.js";
 export * from "./PhotoValueObjectRequestBody.js";
 export * from "./PhotoValueObjectResponseBody.js";
 export * from "./PlaceDeletionMarkerObjectResponseBody.js";
+export * from "./PlaceGeocodeResultResponseResponseBody.js";
 export * from "./PlaceGeofenceCircleInputRequestBody.js";
 export * from "./PlaceGeofenceCircleResponseResponseBody.js";
 export * from "./PlaceGeofenceInputRequestBody.js";
@@ -2008,6 +2009,16 @@ export * from "./PlacesGetPlaceDeletionsResponseBody.js";
 export * from "./PlacesGetPlaceDeletionsServiceUnavailableErrorResponseBody.js";
 export * from "./PlacesGetPlaceDeletionsTooManyRequestsErrorResponseBody.js";
 export * from "./PlacesGetPlaceDeletionsUnauthorizedErrorResponseBody.js";
+export * from "./PlacesGetPlaceGeocodeBadGatewayErrorResponseBody.js";
+export * from "./PlacesGetPlaceGeocodeGatewayTimeoutErrorResponseBody.js";
+export * from "./PlacesGetPlaceGeocodeInternalServerErrorResponseBody.js";
+export * from "./PlacesGetPlaceGeocodeMethodNotAllowedErrorResponseBody.js";
+export * from "./PlacesGetPlaceGeocodeNotFoundErrorResponseBody.js";
+export * from "./PlacesGetPlaceGeocodeNotImplementedErrorResponseBody.js";
+export * from "./PlacesGetPlaceGeocodeResponseBody.js";
+export * from "./PlacesGetPlaceGeocodeServiceUnavailableErrorResponseBody.js";
+export * from "./PlacesGetPlaceGeocodeTooManyRequestsErrorResponseBody.js";
+export * from "./PlacesGetPlaceGeocodeUnauthorizedErrorResponseBody.js";
 export * from "./PlacesGetPlacesBadGatewayErrorResponseBody.js";
 export * from "./PlacesGetPlacesGatewayTimeoutErrorResponseBody.js";
 export * from "./PlacesGetPlacesInternalServerErrorResponseBody.js";

package/dist/cjs/api/types/index.js

@@ -1986,6 +1986,7 @@ __exportStar(require("./PersonDetectedResponseBody.js"), exports);
 __exportStar(require("./PhotoValueObjectRequestBody.js"), exports);
 __exportStar(require("./PhotoValueObjectResponseBody.js"), exports);
 __exportStar(require("./PlaceDeletionMarkerObjectResponseBody.js"), exports);
+__exportStar(require("./PlaceGeocodeResultResponseResponseBody.js"), exports);
 __exportStar(require("./PlaceGeofenceCircleInputRequestBody.js"), exports);
 __exportStar(require("./PlaceGeofenceCircleResponseResponseBody.js"), exports);
 __exportStar(require("./PlaceGeofenceInputRequestBody.js"), exports);
@@ -2024,6 +2025,16 @@ __exportStar(require("./PlacesGetPlaceDeletionsResponseBody.js"), exports);
 __exportStar(require("./PlacesGetPlaceDeletionsServiceUnavailableErrorResponseBody.js"), exports);
 __exportStar(require("./PlacesGetPlaceDeletionsTooManyRequestsErrorResponseBody.js"), exports);
 __exportStar(require("./PlacesGetPlaceDeletionsUnauthorizedErrorResponseBody.js"), exports);
+__exportStar(require("./PlacesGetPlaceGeocodeBadGatewayErrorResponseBody.js"), exports);
+__exportStar(require("./PlacesGetPlaceGeocodeGatewayTimeoutErrorResponseBody.js"), exports);
+__exportStar(require("./PlacesGetPlaceGeocodeInternalServerErrorResponseBody.js"), exports);
+__exportStar(require("./PlacesGetPlaceGeocodeMethodNotAllowedErrorResponseBody.js"), exports);
+__exportStar(require("./PlacesGetPlaceGeocodeNotFoundErrorResponseBody.js"), exports);
+__exportStar(require("./PlacesGetPlaceGeocodeNotImplementedErrorResponseBody.js"), exports);
+__exportStar(require("./PlacesGetPlaceGeocodeResponseBody.js"), exports);
+__exportStar(require("./PlacesGetPlaceGeocodeServiceUnavailableErrorResponseBody.js"), exports);
+__exportStar(require("./PlacesGetPlaceGeocodeTooManyRequestsErrorResponseBody.js"), exports);
+__exportStar(require("./PlacesGetPlaceGeocodeUnauthorizedErrorResponseBody.js"), exports);
 __exportStar(require("./PlacesGetPlacesBadGatewayErrorResponseBody.js"), exports);
 __exportStar(require("./PlacesGetPlacesGatewayTimeoutErrorResponseBody.js"), exports);
 __exportStar(require("./PlacesGetPlacesInternalServerErrorResponseBody.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "13.28.0";
+export declare const SDK_VERSION = "13.29.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "13.28.0";
+exports.SDK_VERSION = "13.29.0";

package/dist/esm/BaseClient.mjs

@@ -7,8 +7,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@samsarahq/samsara",
-        "X-Fern-SDK-Version": "13.28.0",
-        "User-Agent": "@samsarahq/samsara/13.28.0",
+        "X-Fern-SDK-Version": "13.29.0",
+        "User-Agent": "@samsarahq/samsara/13.29.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "X-Samsara-Version": (_a = options === null || options === void 0 ? void 0 : options.version) !== null && _a !== void 0 ? _a : "2025-06-11",

package/dist/esm/api/resources/betaApIs/client/Client.d.mts

@@ -1648,6 +1648,36 @@ export declare class BetaApIsClient {
      */
     getPlaceDeletions(request?: Samsara.GetPlaceDeletionsRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.PlacesGetPlaceDeletionsResponseBody>;
     private __getPlaceDeletions;
+    /**
+     * Forward-geocodes a free-form address string. Does not create or update a Place. Returns geocode candidates with cursor pagination.
+     *
+     *  <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Read Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.GetPlaceGeocodeRequest} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.getPlaceGeocode({
+     *         address: "address"
+     *     })
+     */
+    getPlaceGeocode(request: Samsara.GetPlaceGeocodeRequest, requestOptions?: BetaApIsClient.RequestOptions): core.HttpResponsePromise<Samsara.PlacesGetPlaceGeocodeResponseBody>;
+    private __getPlaceGeocode;
     /**
      * List all preferred fuel stations for your organization.
      *

package/dist/esm/api/resources/betaApIs/client/Client.mjs

@@ -4822,6 +4822,96 @@ export class BetaApIsClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/places/deletions");
         });
     }
+    /**
+     * Forward-geocodes a free-form address string. Does not create or update a Place. Returns geocode candidates with cursor pagination.
+     *
+     *  <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+     *
+     * To use this endpoint, select **Read Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+     *
+     *
+     *  **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+     *
+     * @param {Samsara.GetPlaceGeocodeRequest} request
+     * @param {BetaApIsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Samsara.UnauthorizedError}
+     * @throws {@link Samsara.NotFoundError}
+     * @throws {@link Samsara.MethodNotAllowedError}
+     * @throws {@link Samsara.TooManyRequestsError}
+     * @throws {@link Samsara.InternalServerError}
+     * @throws {@link Samsara.NotImplementedError}
+     * @throws {@link Samsara.BadGatewayError}
+     * @throws {@link Samsara.ServiceUnavailableError}
+     * @throws {@link Samsara.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.betaApIs.getPlaceGeocode({
+     *         address: "address"
+     *     })
+     */
+    getPlaceGeocode(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getPlaceGeocode(request, requestOptions));
+    }
+    __getPlaceGeocode(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { address, after, limit } = request;
+            const _queryParams = {
+                address,
+                after,
+                limit,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Samsara-Version": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.version }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.SamsaraEnvironment.ProductionApi, "places/geocode"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Samsara.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Samsara.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 405:
+                        throw new Samsara.MethodNotAllowedError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Samsara.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Samsara.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Samsara.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new Samsara.BadGatewayError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new Samsara.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    case 504:
+                        throw new Samsara.GatewayTimeoutError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.SamsaraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/places/geocode");
+        });
+    }
     /**
      * List all preferred fuel stations for your organization.
      *

package/dist/esm/api/resources/betaApIs/client/requests/GetPlaceGeocodeRequest.d.mts

@@ -0,0 +1,14 @@
+/**
+ * @example
+ *     {
+ *         address: "address"
+ *     }
+ */
+export interface GetPlaceGeocodeRequest {
+    /** Address string to forward-geocode (URL-encoded). Required; must be non-empty. */
+    address: string;
+    /**  If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results. */
+    after?: string;
+    /** The limit for how many objects will be in the response. Default 5, max 20. */
+    limit?: number;
+}

package/dist/esm/api/resources/betaApIs/client/requests/GetPlaceGeocodeRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/betaApIs/client/requests/index.d.mts

@@ -33,6 +33,7 @@ export type { GetFunctionStorageFileRequest } from "./GetFunctionStorageFileRequ
 export type { GetHosEldEventsRequest } from "./GetHosEldEventsRequest.mjs";
 export type { GetJobsRequest } from "./GetJobsRequest.mjs";
 export type { GetPlaceDeletionsRequest } from "./GetPlaceDeletionsRequest.mjs";
+export type { GetPlaceGeocodeRequest } from "./GetPlaceGeocodeRequest.mjs";
 export type { GetPlacesRequest } from "./GetPlacesRequest.mjs";
 export type { GetPreferredStationRequest } from "./GetPreferredStationRequest.mjs";
 export type { GetQualificationRecordsRequest } from "./GetQualificationRecordsRequest.mjs";

package/dist/esm/api/types/PlaceGeocodeResultResponseResponseBody.d.mts

@@ -0,0 +1,9 @@
+/**
+ * A forward-geocode candidate for an address.
+ */
+export interface PlaceGeocodeResultResponseResponseBody {
+    /** Latitude in WGS84 decimal degrees. */
+    latitude: number;
+    /** Longitude in WGS84 decimal degrees. */
+    longitude: number;
+}

package/dist/esm/api/types/PlaceGeocodeResultResponseResponseBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/PlacesGetPlaceGeocodeBadGatewayErrorResponseBody.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Bad Gateway
+ */
+export interface PlacesGetPlaceGeocodeBadGatewayErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/esm/api/types/PlacesGetPlaceGeocodeBadGatewayErrorResponseBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/PlacesGetPlaceGeocodeGatewayTimeoutErrorResponseBody.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Gateway timeout
+ */
+export interface PlacesGetPlaceGeocodeGatewayTimeoutErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/esm/api/types/PlacesGetPlaceGeocodeGatewayTimeoutErrorResponseBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/PlacesGetPlaceGeocodeInternalServerErrorResponseBody.d.mts

@@ -0,0 +1,9 @@
+/**
+ * An internal server error occurred
+ */
+export interface PlacesGetPlaceGeocodeInternalServerErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/esm/api/types/PlacesGetPlaceGeocodeInternalServerErrorResponseBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/PlacesGetPlaceGeocodeMethodNotAllowedErrorResponseBody.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Method not allowed
+ */
+export interface PlacesGetPlaceGeocodeMethodNotAllowedErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/esm/api/types/PlacesGetPlaceGeocodeMethodNotAllowedErrorResponseBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/PlacesGetPlaceGeocodeNotFoundErrorResponseBody.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Resource not found
+ */
+export interface PlacesGetPlaceGeocodeNotFoundErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/esm/api/types/PlacesGetPlaceGeocodeNotFoundErrorResponseBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/PlacesGetPlaceGeocodeNotImplementedErrorResponseBody.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Requested endpoint is not yet implemented
+ */
+export interface PlacesGetPlaceGeocodeNotImplementedErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/esm/api/types/PlacesGetPlaceGeocodeNotImplementedErrorResponseBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/PlacesGetPlaceGeocodeResponseBody.d.mts

@@ -0,0 +1,6 @@
+import type * as Samsara from "../index.mjs";
+export interface PlacesGetPlaceGeocodeResponseBody {
+    /** Geocode candidates for the requested address. */
+    data: Samsara.PlaceGeocodeResultResponseResponseBody[];
+    pagination: Samsara.GoaPaginationResponseResponseBody;
+}

package/dist/esm/api/types/PlacesGetPlaceGeocodeResponseBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/PlacesGetPlaceGeocodeServiceUnavailableErrorResponseBody.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Service unavailable
+ */
+export interface PlacesGetPlaceGeocodeServiceUnavailableErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/esm/api/types/PlacesGetPlaceGeocodeServiceUnavailableErrorResponseBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/PlacesGetPlaceGeocodeTooManyRequestsErrorResponseBody.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Too many requests
+ */
+export interface PlacesGetPlaceGeocodeTooManyRequestsErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/esm/api/types/PlacesGetPlaceGeocodeTooManyRequestsErrorResponseBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/PlacesGetPlaceGeocodeUnauthorizedErrorResponseBody.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Unauthorized
+ */
+export interface PlacesGetPlaceGeocodeUnauthorizedErrorResponseBody {
+    /** Message of error */
+    message: string;
+    /** The request ID; used when reaching out to support for issues with requests. */
+    requestId: string;
+}

package/dist/esm/api/types/PlacesGetPlaceGeocodeUnauthorizedErrorResponseBody.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/index.d.mts

@@ -1970,6 +1970,7 @@ export * from "./PersonDetectedResponseBody.mjs";
 export * from "./PhotoValueObjectRequestBody.mjs";
 export * from "./PhotoValueObjectResponseBody.mjs";
 export * from "./PlaceDeletionMarkerObjectResponseBody.mjs";
+export * from "./PlaceGeocodeResultResponseResponseBody.mjs";
 export * from "./PlaceGeofenceCircleInputRequestBody.mjs";
 export * from "./PlaceGeofenceCircleResponseResponseBody.mjs";
 export * from "./PlaceGeofenceInputRequestBody.mjs";
@@ -2008,6 +2009,16 @@ export * from "./PlacesGetPlaceDeletionsResponseBody.mjs";
 export * from "./PlacesGetPlaceDeletionsServiceUnavailableErrorResponseBody.mjs";
 export * from "./PlacesGetPlaceDeletionsTooManyRequestsErrorResponseBody.mjs";
 export * from "./PlacesGetPlaceDeletionsUnauthorizedErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeBadGatewayErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeGatewayTimeoutErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeInternalServerErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeMethodNotAllowedErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeNotFoundErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeNotImplementedErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeServiceUnavailableErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeTooManyRequestsErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeUnauthorizedErrorResponseBody.mjs";
 export * from "./PlacesGetPlacesBadGatewayErrorResponseBody.mjs";
 export * from "./PlacesGetPlacesGatewayTimeoutErrorResponseBody.mjs";
 export * from "./PlacesGetPlacesInternalServerErrorResponseBody.mjs";

package/dist/esm/api/types/index.mjs

@@ -1970,6 +1970,7 @@ export * from "./PersonDetectedResponseBody.mjs";
 export * from "./PhotoValueObjectRequestBody.mjs";
 export * from "./PhotoValueObjectResponseBody.mjs";
 export * from "./PlaceDeletionMarkerObjectResponseBody.mjs";
+export * from "./PlaceGeocodeResultResponseResponseBody.mjs";
 export * from "./PlaceGeofenceCircleInputRequestBody.mjs";
 export * from "./PlaceGeofenceCircleResponseResponseBody.mjs";
 export * from "./PlaceGeofenceInputRequestBody.mjs";
@@ -2008,6 +2009,16 @@ export * from "./PlacesGetPlaceDeletionsResponseBody.mjs";
 export * from "./PlacesGetPlaceDeletionsServiceUnavailableErrorResponseBody.mjs";
 export * from "./PlacesGetPlaceDeletionsTooManyRequestsErrorResponseBody.mjs";
 export * from "./PlacesGetPlaceDeletionsUnauthorizedErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeBadGatewayErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeGatewayTimeoutErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeInternalServerErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeMethodNotAllowedErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeNotFoundErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeNotImplementedErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeServiceUnavailableErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeTooManyRequestsErrorResponseBody.mjs";
+export * from "./PlacesGetPlaceGeocodeUnauthorizedErrorResponseBody.mjs";
 export * from "./PlacesGetPlacesBadGatewayErrorResponseBody.mjs";
 export * from "./PlacesGetPlacesGatewayTimeoutErrorResponseBody.mjs";
 export * from "./PlacesGetPlacesInternalServerErrorResponseBody.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "13.28.0";
+export declare const SDK_VERSION = "13.29.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "13.28.0";
+export const SDK_VERSION = "13.29.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@samsarahq/samsara",
-    "version": "13.28.0",
+    "version": "13.29.0",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -4270,6 +4270,78 @@ await client.betaApIs.getPlaceDeletions();
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.betaApIs.<a href="/src/api/resources/betaApIs/client/Client.ts">getPlaceGeocode</a>({ ...params }) -> Samsara.PlacesGetPlaceGeocodeResponseBody</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Forward-geocodes a free-form address string. Does not create or update a Place. Returns geocode candidates with cursor pagination.
+
+ <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
+
+To use this endpoint, select **Read Places** under the Places category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
+ 
+
+ **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.betaApIs.getPlaceGeocode({
+    address: "address"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Samsara.GetPlaceGeocodeRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `BetaApIsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>