apify-client 2.25.1-beta.8 → 3.0.0-beta.1

package/dist/resource_clients/dataset.d.ts

@@ -1,7 +1,9 @@
 import type { STORAGE_GENERAL_ACCESS } from '@apify/consts';
 import type { ApiClientSubResourceOptions } from '../base/api_client';
 import { ResourceClient } from '../base/resource_client';
+import type { Dataset, DatasetStatistics } from '../models';
 import type { PaginatedIterator, PaginationOptions } from '../utils';
+export type { Dataset, DatasetStatistics, DatasetStats, FieldStatistics } from '../models';
 /**
  * Client for managing a specific Dataset.
  *
@@ -222,55 +224,6 @@ export declare class DatasetClient<Data extends Record<string | number, any> = R
     createItemsPublicUrl(options?: DatasetClientCreateItemsUrlOptions): Promise<string>;
     private _createPaginationList;
 }
-/**
- * Represents a dataset storage on the Apify platform.
- *
- * Datasets store structured data as a sequence of items (records). Each item is a JSON object.
- * Datasets are useful for storing results from web scraping, crawling, or data processing tasks.
- */
-export interface Dataset {
-    id: string;
-    name?: string;
-    /**
-     * @since Added in 2.6.1
-     */
-    title?: string;
-    userId: string;
-    /**
-     * @since Added in 2.21.0
-     */
-    username?: string;
-    createdAt: Date;
-    modifiedAt: Date;
-    accessedAt: Date;
-    itemCount: number;
-    cleanItemCount: number;
-    actId?: string;
-    actRunId?: string;
-    stats: DatasetStats;
-    fields: string[];
-    /**
-     * @since Added in 2.12.2
-     */
-    generalAccess?: STORAGE_GENERAL_ACCESS | null;
-    /**
-     * @since Added in 2.13.0
-     */
-    urlSigningSecretKey?: string | null;
-    /**
-     * @since Added in 2.13.0
-     */
-    itemsPublicUrl: string;
-}
-/**
- * Statistics about dataset usage and storage.
- */
-export interface DatasetStats {
-    readCount?: number;
-    writeCount?: number;
-    deleteCount?: number;
-    storageBytes?: number;
-}
 /**
  * Options for updating a dataset.
  */
@@ -315,10 +268,11 @@ export interface DatasetClientListItemOptions extends PaginationOptions {
 /**
  * Options for creating a public URL to access dataset items.
  *
- * Extends {@link DatasetClientListItemOptions} with URL expiration control.
+ * Extends {@link DatasetClientListItemOptions} with URL expiration control, minus `chunkSize` (it only
+ * sizes a client-side iteration) and `signature` (this method produces one).
  * @since Added in 2.16.0
  */
-export interface DatasetClientCreateItemsUrlOptions extends DatasetClientListItemOptions {
+export interface DatasetClientCreateItemsUrlOptions extends Omit<DatasetClientListItemOptions, 'chunkSize' | 'signature'> {
     expiresInSecs?: number;
 }
 /**
@@ -336,9 +290,10 @@ export declare enum DownloadItemsFormat {
 /**
  * Options for downloading dataset items in a specific format.
  *
- * Extends {@link DatasetClientListItemOptions} with format-specific options.
+ * Extends {@link DatasetClientListItemOptions} with format-specific options, minus `chunkSize` - this
+ * downloads the whole range in one request, so there is nothing to size.
  */
-export interface DatasetClientDownloadItemsOptions extends DatasetClientListItemOptions {
+export interface DatasetClientDownloadItemsOptions extends Omit<DatasetClientListItemOptions, 'chunkSize'> {
     attachment?: boolean;
     bom?: boolean;
     delimiter?: string;
@@ -346,22 +301,3 @@ export interface DatasetClientDownloadItemsOptions extends DatasetClientListItem
     xmlRoot?: string;
     xmlRow?: string;
 }
-/**
- * Statistical information about dataset fields.
- *
- * Provides insights into the data structure and content of the dataset.
- * @since Added in 2.11.2
- */
-export interface DatasetStatistics {
-    fieldStatistics: Record<string, FieldStatistics>;
-}
-/**
- * Statistics for a single field in a dataset.
- * @since Added in 2.11.2
- */
-export interface FieldStatistics {
-    min?: number;
-    max?: number;
-    nullCount?: number;
-    emptyCount?: number;
-}

package/dist/resource_clients/dataset.js

@@ -1,11 +1,64 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DownloadItemsFormat = exports.DatasetClient = void 0;
-const tslib_1 = require("tslib");
-const ow_1 = tslib_1.__importDefault(require("ow"));
+const zod_1 = require("zod");
 const utilities_1 = require("@apify/utilities");
 const resource_client_1 = require("../base/resource_client");
 const utils_1 = require("../utils");
+// A predicate, not a `z.object()` arm, which would walk and copy every key of every pushed item.
+const itemSchema = zod_1.z.custom(utils_1.isNonArrayObject, 'Expected an object');
+const listItemsOptionsSchema = zod_1.z.strictObject({
+    clean: zod_1.z.boolean().optional(),
+    desc: zod_1.z.boolean().optional(),
+    flatten: zod_1.z.array(zod_1.z.string()).optional(),
+    fields: zod_1.z.array(zod_1.z.string()).optional(),
+    omit: zod_1.z.array(zod_1.z.string()).optional(),
+    ...utils_1.paginationOptionsShape,
+    skipEmpty: zod_1.z.boolean().optional(),
+    skipHidden: zod_1.z.boolean().optional(),
+    unwind: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional(),
+    view: zod_1.z.string().optional(),
+    signature: zod_1.z.string().optional(),
+});
+// Spells out `limit` / `offset` instead of spreading `paginationOptionsShape`: a download is one
+// request, so `chunkSize` has nothing to size. The options type omits it to match.
+const downloadItemsOptionsSchema = zod_1.z.strictObject({
+    attachment: zod_1.z.boolean().optional(),
+    bom: zod_1.z.boolean().optional(),
+    clean: zod_1.z.boolean().optional(),
+    delimiter: zod_1.z.string().optional(),
+    desc: zod_1.z.boolean().optional(),
+    flatten: zod_1.z.array(zod_1.z.string()).optional(),
+    fields: zod_1.z.array(zod_1.z.string()).optional(),
+    omit: zod_1.z.array(zod_1.z.string()).optional(),
+    limit: zod_1.z.number().min(0).optional(),
+    offset: zod_1.z.number().min(0).optional(),
+    skipEmpty: zod_1.z.boolean().optional(),
+    skipHeaderRow: zod_1.z.boolean().optional(),
+    skipHidden: zod_1.z.boolean().optional(),
+    unwind: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional(),
+    view: zod_1.z.string().optional(),
+    xmlRoot: zod_1.z.string().optional(),
+    xmlRow: zod_1.z.string().optional(),
+    signature: zod_1.z.string().optional(),
+});
+const pushItemsSchema = zod_1.z.union([itemSchema, zod_1.z.string(), zod_1.z.array(zod_1.z.union([itemSchema, zod_1.z.string()]))]);
+// Every option becomes a query parameter of the generated URL, so `chunkSize` (client-side only) and
+// `signature` (which this method produces) are left out. The options type omits both to match.
+const createItemsPublicUrlOptionsSchema = zod_1.z.strictObject({
+    clean: zod_1.z.boolean().optional(),
+    desc: zod_1.z.boolean().optional(),
+    flatten: zod_1.z.array(zod_1.z.string()).optional(),
+    fields: zod_1.z.array(zod_1.z.string()).optional(),
+    omit: zod_1.z.array(zod_1.z.string()).optional(),
+    limit: zod_1.z.number().min(0).optional(),
+    offset: zod_1.z.number().min(0).optional(),
+    skipEmpty: zod_1.z.boolean().optional(),
+    skipHidden: zod_1.z.boolean().optional(),
+    unwind: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional(),
+    view: zod_1.z.string().optional(),
+    expiresInSecs: zod_1.z.number().optional(),
+});
 /**
  * Client for managing a specific Dataset.
  *
@@ -62,7 +115,7 @@ class DatasetClient extends resource_client_1.ResourceClient {
      * @see https://docs.apify.com/api/v2/dataset-put
      */
     async update(newFields) {
-        (0, ow_1.default)(newFields, ow_1.default.object);
+        (0, utils_1.parseArgument)(newFields, utils_1.anyObjectSchema);
         return this._update(newFields, resource_client_1.SMALL_TIMEOUT_MILLIS);
     }
     /**
@@ -118,21 +171,7 @@ class DatasetClient extends resource_client_1.ResourceClient {
      * ```
      */
     listItems(options = {}) {
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            clean: ow_1.default.optional.boolean,
-            desc: ow_1.default.optional.boolean,
-            flatten: ow_1.default.optional.array.ofType(ow_1.default.string),
-            fields: ow_1.default.optional.array.ofType(ow_1.default.string),
-            omit: ow_1.default.optional.array.ofType(ow_1.default.string),
-            limit: ow_1.default.optional.number.not.negative,
-            offset: ow_1.default.optional.number.not.negative,
-            chunkSize: ow_1.default.optional.number.positive,
-            skipEmpty: ow_1.default.optional.boolean,
-            skipHidden: ow_1.default.optional.boolean,
-            unwind: ow_1.default.optional.any(ow_1.default.string, ow_1.default.array.ofType(ow_1.default.string)),
-            view: ow_1.default.optional.string,
-            signature: ow_1.default.optional.string,
-        }));
+        const parsed = (0, utils_1.parseArgument)(options, listItemsOptionsSchema, 'DatasetClientListItemOptions');
         const fetchItems = async (datasetListOptions = {}) => {
             const response = await this.httpClient.call({
                 url: this._url('items'),
@@ -142,7 +181,7 @@ class DatasetClient extends resource_client_1.ResourceClient {
             });
             return this._createPaginationList(response, datasetListOptions.desc ?? false);
         };
-        return this._listPaginatedFromCallback(fetchItems, options);
+        return this._listPaginatedFromCallback(fetchItems, parsed);
     }
     /**
      * Downloads dataset items in a specific format.
@@ -185,33 +224,14 @@ class DatasetClient extends resource_client_1.ResourceClient {
      * ```
      */
     async downloadItems(format, options = {}) {
-        (0, ow_1.default)(format, ow_1.default.string.oneOf(validItemFormats));
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            attachment: ow_1.default.optional.boolean,
-            bom: ow_1.default.optional.boolean,
-            clean: ow_1.default.optional.boolean,
-            delimiter: ow_1.default.optional.string,
-            desc: ow_1.default.optional.boolean,
-            flatten: ow_1.default.optional.array.ofType(ow_1.default.string),
-            fields: ow_1.default.optional.array.ofType(ow_1.default.string),
-            omit: ow_1.default.optional.array.ofType(ow_1.default.string),
-            limit: ow_1.default.optional.number.not.negative,
-            offset: ow_1.default.optional.number.not.negative,
-            skipEmpty: ow_1.default.optional.boolean,
-            skipHeaderRow: ow_1.default.optional.boolean,
-            skipHidden: ow_1.default.optional.boolean,
-            unwind: ow_1.default.any(ow_1.default.optional.string, ow_1.default.optional.array.ofType(ow_1.default.string)),
-            view: ow_1.default.optional.string,
-            xmlRoot: ow_1.default.optional.string,
-            xmlRow: ow_1.default.optional.string,
-            signature: ow_1.default.optional.string,
-        }));
+        (0, utils_1.parseArgument)(format, itemFormatSchema);
+        const parsed = (0, utils_1.parseArgument)(options, downloadItemsOptionsSchema, 'DatasetClientDownloadItemsOptions');
         const { data } = await this.httpClient.call({
             url: this._url('items'),
             method: 'GET',
             params: this._params({
                 format,
-                ...options,
+                ...parsed,
             }),
             forceBuffer: true,
             timeout: resource_client_1.DEFAULT_TIMEOUT_MILLIS,
@@ -251,7 +271,7 @@ class DatasetClient extends resource_client_1.ResourceClient {
      * ```
      */
     async pushItems(items) {
-        (0, ow_1.default)(items, ow_1.default.any(ow_1.default.object, ow_1.default.string, ow_1.default.array.ofType(ow_1.default.any(ow_1.default.object, ow_1.default.string))));
+        (0, utils_1.parseArgument)(items, pushItemsSchema);
         await this.httpClient.call({
             url: this._url('items'),
             method: 'POST',
@@ -323,22 +343,9 @@ class DatasetClient extends resource_client_1.ResourceClient {
      * @since Added in 2.13.0
      */
     async createItemsPublicUrl(options = {}) {
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            clean: ow_1.default.optional.boolean,
-            desc: ow_1.default.optional.boolean,
-            flatten: ow_1.default.optional.array.ofType(ow_1.default.string),
-            fields: ow_1.default.optional.array.ofType(ow_1.default.string),
-            omit: ow_1.default.optional.array.ofType(ow_1.default.string),
-            limit: ow_1.default.optional.number.not.negative,
-            offset: ow_1.default.optional.number.not.negative,
-            skipEmpty: ow_1.default.optional.boolean,
-            skipHidden: ow_1.default.optional.boolean,
-            unwind: ow_1.default.optional.any(ow_1.default.string, ow_1.default.array.ofType(ow_1.default.string)),
-            view: ow_1.default.optional.string,
-            expiresInSecs: ow_1.default.optional.number,
-        }));
+        const parsed = (0, utils_1.parseArgument)(options, createItemsPublicUrlOptionsSchema, 'DatasetClientCreateItemsUrlOptions');
         const dataset = await this.get();
-        const { expiresInSecs, ...queryOptions } = options;
+        const { expiresInSecs, ...queryOptions } = parsed;
         let createdItemsPublicUrl = new URL(this._publicUrl('items'));
         if (dataset?.urlSigningSecretKey) {
             const signature = await (0, utilities_1.createStorageContentSignatureAsync)({
@@ -378,3 +385,5 @@ var DownloadItemsFormat;
     DownloadItemsFormat["RSS"] = "rss";
 })(DownloadItemsFormat || (exports.DownloadItemsFormat = DownloadItemsFormat = {}));
 const validItemFormats = [...new Set(Object.values(DownloadItemsFormat).map((item) => item.toLowerCase()))];
+// Declared below `validItemFormats` because it references it at module load time.
+const itemFormatSchema = zod_1.z.enum(validItemFormats);

package/dist/resource_clients/dataset_collection.js

@@ -1,10 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DatasetCollectionClient = void 0;
-const tslib_1 = require("tslib");
-const ow_1 = tslib_1.__importDefault(require("ow"));
+const zod_1 = require("zod");
 const consts_1 = require("@apify/consts");
 const resource_collection_client_1 = require("../base/resource_collection_client");
+const utils_1 = require("../utils");
+const listOptionsSchema = zod_1.z.strictObject({
+    unnamed: zod_1.z.boolean().optional(),
+    ...utils_1.paginationOptionsShape,
+    desc: zod_1.z.boolean().optional(),
+    ownership: zod_1.z.enum(consts_1.STORAGE_OWNERSHIP_FILTER).optional(),
+});
+const nameSchema = zod_1.z.string().optional();
+const schemaSchema = utils_1.anyObjectSchema.optional();
 /**
  * Client for managing the collection of datasets in your account.
  *
@@ -56,14 +64,8 @@ class DatasetCollectionClient extends resource_collection_client_1.ResourceColle
      * @see https://docs.apify.com/api/v2/datasets-get
      */
     list(options = {}) {
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            unnamed: ow_1.default.optional.boolean,
-            limit: ow_1.default.optional.number.not.negative,
-            offset: ow_1.default.optional.number.not.negative,
-            desc: ow_1.default.optional.boolean,
-            ownership: ow_1.default.optional.string.oneOf(Object.values(consts_1.STORAGE_OWNERSHIP_FILTER)),
-        }));
-        return this._listPaginated(options);
+        const parsed = (0, utils_1.parseArgument)(options, listOptionsSchema, 'DatasetCollectionClientListOptions');
+        return this._listPaginated(parsed);
     }
     /**
      * Gets or creates a dataset with the specified name.
@@ -74,8 +76,8 @@ class DatasetCollectionClient extends resource_collection_client_1.ResourceColle
      * @see https://docs.apify.com/api/v2/datasets-post
      */
     async getOrCreate(name, options) {
-        (0, ow_1.default)(name, ow_1.default.optional.string);
-        (0, ow_1.default)(options?.schema, ow_1.default.optional.object); // TODO: Add schema validatioon
+        (0, utils_1.parseArgument)(name, nameSchema);
+        (0, utils_1.parseArgument)(options?.schema, schemaSchema); // TODO: Add schema validation
         return this._getOrCreate(name, options);
     }
 }

package/dist/resource_clients/key_value_store.d.ts

@@ -3,6 +3,8 @@ import type { JsonValue } from 'type-fest';
 import type { STORAGE_GENERAL_ACCESS } from '@apify/consts';
 import type { ApiClientSubResourceOptions } from '../base/api_client';
 import { ResourceClient } from '../base/resource_client';
+import type { KeyValueClientListKeysResult, KeyValueListItem, KeyValueStore } from '../models';
+export type { KeyValueClientListKeysResult, KeyValueListItem, KeyValueStore, KeyValueStoreStats } from '../models';
 /**
  * Client for managing a specific key-value store.
  *
@@ -231,53 +233,6 @@ export declare class KeyValueStoreClient extends ResourceClient {
      */
     deleteRecord(key: string): Promise<void>;
 }
-/**
- * Represents a Key-Value Store storage on the Apify platform.
- *
- * Key-value stores are used to store arbitrary data records or files. Each record is identified
- * by a unique key and can contain any data - JSON objects, strings, binary files, etc.
- */
-export interface KeyValueStore {
-    id: string;
-    name?: string;
-    /**
-     * @since Added in 2.6.1
-     */
-    title?: string;
-    userId: string;
-    /**
-     * @since Added in 2.21.0
-     */
-    username?: string;
-    createdAt: Date;
-    modifiedAt: Date;
-    accessedAt: Date;
-    actId?: string;
-    actRunId?: string;
-    stats?: KeyValueStoreStats;
-    /**
-     * @since Added in 2.12.2
-     */
-    generalAccess?: STORAGE_GENERAL_ACCESS | null;
-    /**
-     * @since Added in 2.13.0
-     */
-    urlSigningSecretKey?: string | null;
-    /**
-     * @since Added in 2.13.0
-     */
-    keysPublicUrl: string;
-}
-/**
- * Statistics about Key-Value Store usage and storage.
- */
-export interface KeyValueStoreStats {
-    readCount?: number;
-    writeCount?: number;
-    deleteCount?: number;
-    listCount?: number;
-    storageBytes?: number;
-}
 /**
  * Options for updating a Key-Value Store.
  */
@@ -311,36 +266,13 @@ export interface KeyValueClientListKeysOptions {
 /**
  * Options for creating a public URL to list keys in a Key-Value Store.
  *
- * Extends {@link KeyValueClientListKeysOptions} with URL expiration control.
+ * Extends {@link KeyValueClientListKeysOptions} with URL expiration control, minus `signature` (this
+ * method produces one).
  * @since Added in 2.16.0
  */
-export interface KeyValueClientCreateKeysUrlOptions extends KeyValueClientListKeysOptions {
+export interface KeyValueClientCreateKeysUrlOptions extends Omit<KeyValueClientListKeysOptions, 'signature'> {
     expiresInSecs?: number;
 }
-/**
- * Result of listing keys in a Key-Value Store.
- *
- * Contains paginated list of keys with metadata and pagination information.
- */
-export interface KeyValueClientListKeysResult {
-    count: number;
-    limit: number;
-    exclusiveStartKey: string;
-    isTruncated: boolean;
-    nextExclusiveStartKey: string;
-    items: KeyValueListItem[];
-}
-/**
- * Metadata about a single key in a Key-Value Store.
- */
-export interface KeyValueListItem {
-    key: string;
-    size: number;
-    /**
-     * @since Added in 2.15.1
-     */
-    recordPublicUrl: string;
-}
 /**
  * Options for retrieving a record from a Key-Value Store.
  */

package/dist/resource_clients/key_value_store.js

@@ -2,11 +2,51 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KeyValueStoreClient = void 0;
 const tslib_1 = require("tslib");
-const ow_1 = tslib_1.__importDefault(require("ow"));
+const zod_1 = require("zod");
 const log_1 = tslib_1.__importDefault(require("@apify/log"));
 const utilities_1 = require("@apify/utilities");
 const resource_client_1 = require("../base/resource_client");
 const utils_1 = require("../utils");
+const listKeysOptionsSchema = zod_1.z.strictObject({
+    limit: zod_1.z.number().min(0).optional(),
+    exclusiveStartKey: zod_1.z.string().optional(),
+    collection: zod_1.z.string().optional(),
+    prefix: zod_1.z.string().optional(),
+    signature: zod_1.z.string().optional(),
+});
+const nonEmptyKeySchema = zod_1.z.string().min(1);
+// `signature` is left out - this method produces one. The options type omits it to match.
+const createKeysPublicUrlOptionsSchema = zod_1.z.strictObject({
+    limit: zod_1.z.number().min(0).optional(),
+    exclusiveStartKey: zod_1.z.string().optional(),
+    collection: zod_1.z.string().optional(),
+    prefix: zod_1.z.string().optional(),
+    expiresInSecs: zod_1.z.number().optional(),
+});
+const keySchema = zod_1.z.string();
+const getRecordOptionsSchema = zod_1.z.strictObject({
+    buffer: zod_1.z.boolean().optional(),
+    stream: zod_1.z.boolean().optional(),
+    disableRedirect: zod_1.z.boolean().optional(),
+    signature: zod_1.z.string().optional(),
+});
+const recordSchema = zod_1.z.strictObject({
+    key: zod_1.z.string(),
+    // Values are arbitrary, and a `z.object()` arm would walk every key of a large buffer.
+    // Symbols, bigints, functions and non-finite numbers are rejected because they cannot be serialized
+    // to JSON - symbols and bigints throw, functions stringify to `undefined` (an empty request body),
+    // and `NaN` / `Infinity` would silently become `null`.
+    value: zod_1.z.custom((value) => value !== undefined &&
+        typeof value !== 'symbol' &&
+        typeof value !== 'bigint' &&
+        typeof value !== 'function' &&
+        (typeof value !== 'number' || Number.isFinite(value)), 'Expected a defined, JSON-serializable value'),
+    contentType: zod_1.z.string().min(1).optional(),
+});
+const recordOptionsSchema = zod_1.z.strictObject({
+    timeoutSecs: zod_1.z.number().optional(),
+    doNotRetryTimeouts: zod_1.z.boolean().optional(),
+});
 /**
  * Client for managing a specific key-value store.
  *
@@ -65,7 +105,7 @@ class KeyValueStoreClient extends resource_client_1.ResourceClient {
      * @see https://docs.apify.com/api/v2/key-value-store-put
      */
     async update(newFields) {
-        (0, ow_1.default)(newFields, ow_1.default.object);
+        (0, utils_1.parseArgument)(newFields, utils_1.anyObjectSchema);
         return this._update(newFields, resource_client_1.DEFAULT_TIMEOUT_MILLIS);
     }
     /**
@@ -112,13 +152,7 @@ class KeyValueStoreClient extends resource_client_1.ResourceClient {
      * ```
      */
     listKeys(options = {}) {
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            limit: ow_1.default.optional.number.not.negative,
-            exclusiveStartKey: ow_1.default.optional.string,
-            collection: ow_1.default.optional.string,
-            prefix: ow_1.default.optional.string,
-            signature: ow_1.default.optional.string,
-        }));
+        const parsed = (0, utils_1.parseArgument)(options, listKeysOptionsSchema, 'KeyValueClientListKeysOptions');
         const getPaginatedList = async (kvsListOptions = {}) => {
             const response = await this.httpClient.call({
                 url: this._url('keys'),
@@ -128,17 +162,19 @@ class KeyValueStoreClient extends resource_client_1.ResourceClient {
             });
             return (0, utils_1.cast)((0, utils_1.parseDateFields)((0, utils_1.pluckData)(response.data)));
         };
-        const paginatedListPromise = getPaginatedList(options);
+        const paginatedListPromise = getPaginatedList(parsed);
         async function* asyncGenerator() {
             let currentPage = await paginatedListPromise;
             yield* currentPage.items;
-            let remainingItems = options.limit ? options.limit - currentPage.items.length : undefined;
+            let remainingItems = parsed.limit ? parsed.limit - currentPage.items.length : undefined;
             while (currentPage.items.length > 0 && // Continue only if at least some items were returned in the last page.
-                currentPage.nextExclusiveStartKey !== null && // Continue only if there is some next key.
+                // Continue only if there is some next key. The API answers with `null` on the last page and
+                // omits the field entirely for a listing that was not truncated.
+                currentPage.nextExclusiveStartKey != null &&
                 (remainingItems === undefined || remainingItems > 0) // Continue only if the limit was not exceeded.
             ) {
                 const newOptions = {
-                    ...options,
+                    ...parsed,
                     limit: remainingItems,
                     exclusiveStartKey: currentPage.nextExclusiveStartKey,
                 };
@@ -172,9 +208,9 @@ class KeyValueStoreClient extends resource_client_1.ResourceClient {
      * @since Added in 2.14.0
      */
     async getRecordPublicUrl(key) {
-        (0, ow_1.default)(key, ow_1.default.string.nonEmpty);
+        (0, utils_1.parseArgument)(key, nonEmptyKeySchema);
         const store = await this.get();
-        const recordPublicUrl = new URL(this._publicUrl(`records/${key}`));
+        const recordPublicUrl = new URL(this._publicUrl(['records', key]));
         if (store?.urlSigningSecretKey) {
             const signature = await (0, utilities_1.createHmacSignatureAsync)(store.urlSigningSecretKey, key);
             recordPublicUrl.searchParams.append('signature', signature);
@@ -205,15 +241,9 @@ class KeyValueStoreClient extends resource_client_1.ResourceClient {
      * @since Added in 2.13.0
      */
     async createKeysPublicUrl(options = {}) {
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            limit: ow_1.default.optional.number.not.negative,
-            exclusiveStartKey: ow_1.default.optional.string,
-            collection: ow_1.default.optional.string,
-            prefix: ow_1.default.optional.string,
-            expiresInSecs: ow_1.default.optional.number,
-        }));
+        const parsed = (0, utils_1.parseArgument)(options, createKeysPublicUrlOptionsSchema, 'KeyValueClientCreateKeysUrlOptions');
         const store = await this.get();
-        const { expiresInSecs, ...queryOptions } = options;
+        const { expiresInSecs, ...queryOptions } = parsed;
         let createdPublicKeysUrl = new URL(this._publicUrl('keys'));
         if (store?.urlSigningSecretKey) {
             const signature = await (0, utilities_1.createStorageContentSignatureAsync)({
@@ -246,7 +276,7 @@ class KeyValueStoreClient extends resource_client_1.ResourceClient {
      */
     async recordExists(key) {
         const requestOpts = {
-            url: this._url(`records/${key}`),
+            url: this._url(['records', key]),
             method: 'HEAD',
             params: this._params(),
         };
@@ -260,32 +290,27 @@ class KeyValueStoreClient extends resource_client_1.ResourceClient {
         return false;
     }
     async getRecord(key, options = {}) {
-        (0, ow_1.default)(key, ow_1.default.string);
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            buffer: ow_1.default.optional.boolean,
-            stream: ow_1.default.optional.boolean,
-            disableRedirect: ow_1.default.optional.boolean,
-            signature: ow_1.default.optional.string,
-        }));
-        if (options.stream && !(0, utils_1.isNode)()) {
+        (0, utils_1.parseArgument)(key, keySchema);
+        const parsed = (0, utils_1.parseArgument)(options, getRecordOptionsSchema, 'KeyValueClientGetRecordOptions');
+        if (parsed.stream && !(0, utils_1.isNode)()) {
             throw new Error('The stream option can only be used in Node.js environment.');
         }
-        if ('disableRedirect' in options) {
+        if ('disableRedirect' in parsed) {
             log_1.default.deprecated('The disableRedirect option for getRecord() is deprecated. ' +
                 'It has no effect and will be removed in the following major release.');
         }
         const queryParams = { attachment: 'true' };
-        if (options.signature)
-            queryParams.signature = options.signature;
+        if (parsed.signature)
+            queryParams.signature = parsed.signature;
         const requestOpts = {
-            url: this._url(`records/${key}`),
+            url: this._url(['records', key]),
             method: 'GET',
             params: this._params(queryParams),
             timeout: resource_client_1.DEFAULT_TIMEOUT_MILLIS,
         };
-        if (options.buffer)
+        if (parsed.buffer)
             requestOpts.forceBuffer = true;
-        if (options.stream)
+        if (parsed.stream)
             requestOpts.responseType = 'stream';
         try {
             const response = await this.httpClient.call(requestOpts);
@@ -348,18 +373,11 @@ class KeyValueStoreClient extends resource_client_1.ResourceClient {
      * ```
      */
     async setRecord(record, options = {}) {
-        (0, ow_1.default)(record, ow_1.default.object.exactShape({
-            key: ow_1.default.string,
-            value: ow_1.default.any(ow_1.default.null, ow_1.default.string, ow_1.default.number, ow_1.default.object, ow_1.default.boolean),
-            contentType: ow_1.default.optional.string.nonEmpty,
-        }));
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            timeoutSecs: ow_1.default.optional.number,
-            doNotRetryTimeouts: ow_1.default.optional.boolean,
-        }));
+        (0, utils_1.parseArgument)(record, recordSchema);
+        const parsed = (0, utils_1.parseArgument)(options, recordOptionsSchema, 'KeyValueStoreRecordOptions');
         const { key } = record;
         let { value, contentType } = record;
-        const { timeoutSecs, doNotRetryTimeouts } = options;
+        const { timeoutSecs, doNotRetryTimeouts } = parsed;
         const isValueStreamOrBuffer = (0, utils_1.isStream)(value) || (0, utils_1.isBuffer)(value);
         // To allow saving Objects to JSON without providing content type
         if (!contentType) {
@@ -381,7 +399,7 @@ class KeyValueStoreClient extends resource_client_1.ResourceClient {
             }
         }
         const uploadOpts = {
-            url: this._url(`records/${key}`),
+            url: this._url(['records', key]),
             method: 'PUT',
             params: this._params(),
             data: value,
@@ -403,9 +421,9 @@ class KeyValueStoreClient extends resource_client_1.ResourceClient {
      * ```
      */
     async deleteRecord(key) {
-        (0, ow_1.default)(key, ow_1.default.string);
+        (0, utils_1.parseArgument)(key, keySchema);
         await this.httpClient.call({
-            url: this._url(`records/${key}`),
+            url: this._url(['records', key]),
             method: 'DELETE',
             params: this._params(),
             timeout: resource_client_1.SMALL_TIMEOUT_MILLIS,