@commercelayer/sdk 5.35.0 → 6.0.0-alfa.10

package/lib/esm/error.js

@@ -1,4 +1,4 @@
-import axios from 'axios';
+import { FetchError } from './fetch';
 var ErrorType;
 (function (ErrorType) {
     ErrorType["CLIENT"] = "client";
@@ -6,64 +6,73 @@ var ErrorType;
     ErrorType["RESPONSE"] = "response";
     ErrorType["CANCEL"] = "cancel";
     ErrorType["PARSE"] = "parse";
-    ErrorType["GENERIC"] = "generic";
+    ErrorType["TIMEOUT"] = "timeout";
 })(ErrorType || (ErrorType = {}));
 class SdkError extends Error {
+    static NAME = 'SdkError';
     static isSdkError(error) {
         return error && [SdkError.NAME, ApiError.NAME].includes(error.name) && Object.values(ErrorType).includes(error.type);
     }
+    type;
+    code;
+    source;
     constructor(error) {
         super(error.message);
-        this.name = SdkError.NAME; // this.constructor.name
-        this.type = error.type || ErrorType.GENERIC;
+        this.name = SdkError.NAME;
+        this.type = error.type || ErrorType.CLIENT;
     }
 }
-SdkError.NAME = 'SdkError';
 class ApiError extends SdkError {
+    static NAME = 'ApiError';
     static isApiError(error) {
         return SdkError.isSdkError(error) && (error.name === ApiError.NAME) && (error.type === ErrorType.RESPONSE);
     }
+    errors = [];
+    status;
+    statusText;
     constructor(error) {
         super({ ...error, type: ErrorType.RESPONSE });
-        this.errors = [];
-        this.name = ApiError.NAME; // this.constructor.name
+        this.name = ApiError.NAME;
     }
     first() {
-        var _a;
-        return (((_a = this.errors) === null || _a === void 0 ? void 0 : _a.length) > 0) ? this.errors[0] : undefined;
+        return (this.errors?.length > 0) ? this.errors[0] : undefined;
     }
 }
-ApiError.NAME = 'ApiError';
+const isRequestError = (error) => {
+    return error instanceof TypeError;
+};
+const isCancelError = (error) => {
+    return (error instanceof DOMException) && (error.name === 'AbortError');
+};
+const isTimeoutError = (error) => {
+    return (error instanceof DOMException) && (error.name === 'TimeoutError');
+};
 const handleError = (error) => {
     let sdkError = new SdkError({ message: error.message });
-    if (axios.isAxiosError(error)) {
-        if (error.response) {
-            // The request was made and the server responded with a status code that falls out of the range of 2xx
-            const apiError = new ApiError(sdkError);
-            apiError.type = ErrorType.RESPONSE;
-            apiError.status = error.response.status;
-            apiError.statusText = error.response.statusText;
-            apiError.code = String(apiError.status);
-            apiError.errors = error.response.data.errors;
-            if (!apiError.message && apiError.statusText)
-                apiError.message = apiError.statusText;
-            sdkError = apiError;
-        }
-        else if (error.request) {
-            // The request was made but no response was received
-            // `error.request` is an instance of XMLHttpRequest in the browser and an instance of http.ClientRequest in node.js
-            sdkError.type = ErrorType.REQUEST;
-            sdkError.request = error.request;
-        }
-        else {
-            // Something happened in setting up the request that triggered an Error
-            sdkError.type = ErrorType.CLIENT;
-        }
+    if (FetchError.isFetchError(error)) {
+        const apiError = new ApiError(sdkError);
+        apiError.type = ErrorType.RESPONSE;
+        apiError.status = error.status;
+        apiError.statusText = error.statusText;
+        apiError.code = String(apiError.status);
+        apiError.errors = error.errors || [];
+        if (!apiError.message && apiError.statusText)
+            apiError.message = apiError.statusText;
+        sdkError = apiError;
+    }
+    else if (isRequestError(error)) {
+        sdkError.type = ErrorType.REQUEST;
     }
-    else if (axios.isCancel(error))
+    else if (isCancelError(error)) {
         sdkError.type = ErrorType.CANCEL;
-    else
+    }
+    else if (isTimeoutError(error)) {
+        sdkError.type = ErrorType.TIMEOUT;
+    }
+    else {
+        sdkError.type = ErrorType.CLIENT;
         sdkError.source = error;
+    }
     throw sdkError;
 };
 export { SdkError, ApiError, ErrorType, handleError };

package/lib/esm/fetch.d.ts

@@ -0,0 +1,13 @@
+import type { DocWithData } from 'jsonapi-typescript';
+import type { InterceptorManager } from './interceptor';
+export type FetchResponse = DocWithData;
+export type FetchOptions = RequestInit;
+export declare class FetchError extends Error {
+    #private;
+    static isFetchError: (error: any) => error is FetchError;
+    constructor(status: number, statusText: string, body?: any);
+    get errors(): any[] | undefined;
+    get status(): number;
+    get statusText(): string;
+}
+export declare const fetchURL: (url: URL, options: FetchOptions, interceptors?: InterceptorManager) => Promise<FetchResponse>;

package/lib/esm/fetch.js

@@ -0,0 +1,46 @@
+import Debug from './debug';
+const debug = Debug('fetch');
+export class FetchError extends Error {
+    static isFetchError = (error) => {
+        return error instanceof FetchError;
+    };
+    #errors;
+    #status;
+    #statusText;
+    constructor(status, statusText, body) {
+        super(statusText);
+        this.#status = status;
+        this.#statusText = statusText;
+        if (body)
+            this.#errors = body.errors;
+    }
+    get errors() { return this.#errors; }
+    get status() { return this.#status; }
+    get statusText() { return this.#statusText; }
+}
+export const fetchURL = async (url, options, interceptors) => {
+    debug('fetch: %s, %O', url, options || {});
+    if (interceptors?.request?.onSuccess)
+        ({ url, options } = await interceptors.request.onSuccess({ url, options }));
+    const request = new Request(url, options);
+    let response = await fetch(request);
+    if (response.ok) {
+        if (interceptors?.rawReader?.onSuccess)
+            await interceptors.rawReader.onSuccess(response);
+        if (interceptors?.response?.onSuccess)
+            response = await interceptors.response.onSuccess(response);
+    }
+    else {
+        if (interceptors?.rawReader?.onFailure)
+            await interceptors.rawReader.onFailure(response);
+    }
+    const responseBody = await response.json().catch(() => { });
+    if (!response.ok) {
+        let error = new FetchError(response.status, response.statusText, responseBody);
+        if (interceptors?.response?.onFailure)
+            error = await interceptors.response.onFailure(error);
+        if (error)
+            throw error;
+    }
+    return responseBody;
+};

package/lib/esm/index.js

@@ -1,4 +1,2 @@
-// SDK
 export { default, CommerceLayer } from './commercelayer';
-// Commerce Layer static functions
 export { CommerceLayerStatic } from './static';

package/lib/esm/interceptor.d.ts

@@ -1,25 +1,37 @@
-import type { AxiosError, AxiosInterceptorManager, AxiosRequestConfig, AxiosResponse, AxiosResponseHeaders, RawAxiosResponseHeaders } from 'axios';
+import type { FetchError, FetchOptions } from "./fetch";
+type InterceptorEventManager<S extends (RequestInterceptor | ResponseInterceptor), F extends (ErrorInterceptor | ResponseInterceptor)> = {
+    onSuccess?: S;
+    onFailure?: F;
+};
+type RequestEventManager = InterceptorEventManager<RequestInterceptor, ErrorInterceptor>;
+type ResponseEventManager = InterceptorEventManager<ResponseInterceptor, ErrorInterceptor>;
+type ErrorEventManager = InterceptorEventManager<ResponseInterceptor, ResponseInterceptor>;
 type InterceptorManager = {
-    request: AxiosInterceptorManager<AxiosRequestConfig>;
-    response: AxiosInterceptorManager<any>;
+    request?: RequestEventManager;
+    response?: ResponseEventManager;
+    rawReader?: ErrorEventManager;
+};
+type RequestObj = {
+    url: URL;
+    options: FetchOptions;
 };
-type RequestObj = AxiosRequestConfig;
 type RequestInterceptor = (request: RequestObj) => RequestObj | Promise<RequestObj>;
-type ResponseObj = AxiosResponse;
+type ResponseObj = Response;
 type ResponseInterceptor = (response: ResponseObj) => ResponseObj | Promise<ResponseObj>;
 type ApiHeadersList = 'x-ratelimit-limit' | 'x-ratelimit-count' | 'x-ratelimit-period' | 'x-ratelimit-interval' | 'x-ratelimit-remaining';
 type ApiHeaders = {
     [key in ApiHeadersList]: string | number | boolean;
 };
-type HeadersObj = (AxiosResponseHeaders | RawAxiosResponseHeaders) & ApiHeaders;
-type ErrorObj = AxiosError;
+type HeadersObj = Record<string, string> | ApiHeaders;
+type ErrorObj = FetchError;
 type ErrorInterceptor = (error: ErrorObj) => ErrorObj | Promise<ErrorObj>;
 type InterceptorType = 'request' | 'response';
 export type { InterceptorManager, RequestInterceptor, ResponseInterceptor, ErrorInterceptor, InterceptorType };
 export type { RequestObj, ResponseObj, ErrorObj, HeadersObj };
 type RawResponseReader = {
-    id: number | undefined;
-    rawResponse: ResponseObj | undefined;
-    headers: HeadersObj | undefined;
+    id?: number;
+    rawResponse?: any;
+    headers?: HeadersObj;
+    ok: boolean;
 };
 export type { RawResponseReader };

package/lib/esm/jsonapi.js

@@ -2,7 +2,6 @@ import { isResourceId, isResourceType } from './common';
 import config from './config';
 import Debug from './debug';
 const debug = Debug('jsonapi');
-// DENORMALIZATION
 const denormalize = (response) => {
     let denormalizedResponse;
     if (response.links)
@@ -53,7 +52,6 @@ const denormalizeResource = (res, included, chain = []) => {
     debug('denormalized resource: %O', resource);
     return resource;
 };
-// NORMALIZATION
 const normalize = (resource) => {
     debug('normalize resource: %O', resource);
     const attributes = {};

package/lib/esm/model.d.ts

@@ -1,6 +1,3 @@
-/**
- * ©2024 Commerce Layer Inc.
- **/
 export type { Address, AddressCreate, AddressUpdate } from './resources/addresses';
 export type { Adjustment, AdjustmentCreate, AdjustmentUpdate } from './resources/adjustments';
 export type { AdyenGateway, AdyenGatewayCreate, AdyenGatewayUpdate } from './resources/adyen_gateways';

package/lib/esm/model.js

@@ -1,2 +1 @@
 export {};
-// ##__MODEL_TYPES_STOP__##

package/lib/esm/query.d.ts

@@ -14,4 +14,5 @@ type QueryParams = QueryParamsRetrieve | QueryParamsList;
 export type { QueryParamsRetrieve, QueryParamsList, QueryParams, QueryFilter };
 declare const isParamsList: (params: any) => params is QueryParamsList;
 declare const generateQueryStringParams: (params: QueryParamsRetrieve | QueryParamsList | undefined, res: string | ResourceType) => Record<string, string>;
-export { generateQueryStringParams, isParamsList };
+declare const generateSearchString: (params?: QueryParams, questionMark?: boolean) => string;
+export { generateQueryStringParams, isParamsList, generateSearchString };

package/lib/esm/query.js

@@ -1,5 +1,5 @@
-import Debug from './debug';
 import { ErrorType, SdkError } from "./error";
+import Debug from './debug';
 const debug = Debug('query');
 const arrayFilters = ['_any', '_all', '_in'];
 const objectFilters = ['_jcont'];
@@ -11,10 +11,8 @@ const generateQueryStringParams = (params, res) => {
     const qp = {};
     if (!params)
         return qp;
-    // Include
     if (params.include)
         qp.include = params.include.join(',');
-    // Fields
     if (params.fields) {
         if (Array.isArray(params.fields))
             params.fields = { [res.type || res]: params.fields };
@@ -23,19 +21,16 @@ const generateQueryStringParams = (params, res) => {
         });
     }
     if (isParamsList(params)) {
-        // Sort
         if (params.sort) {
             if (Array.isArray(params.sort))
                 qp.sort = params.sort.join(',');
             else
                 qp.sort = Object.entries(params.sort).map(([k, v]) => `${v === 'desc' ? '-' : ''}${k}`).join(',');
         }
-        // Page
         if (params.pageNumber)
             qp['page[number]'] = String(params.pageNumber);
         if (params.pageSize)
             qp['page[size]'] = String(params.pageSize);
-        // Filters
         if (params.filters) {
             Object.entries(params.filters).forEach(([p, v]) => {
                 const filter = p.substring(p.lastIndexOf('_'));
@@ -59,4 +54,9 @@ const generateQueryStringParams = (params, res) => {
     debug('query string params: %O', qp);
     return qp;
 };
-export { generateQueryStringParams, isParamsList };
+const generateSearchString = (params, questionMark = true) => {
+    if (!params || (Object.keys(params).length === 0))
+        return '';
+    return `${questionMark ? '?' : ''}${Object.entries(params).map(([key, val]) => `${key}=${String(val)}`).join('&')}`;
+};
+export { generateQueryStringParams, isParamsList, generateSearchString };

package/lib/esm/resource.d.ts

@@ -1,7 +1,6 @@
 import ApiClient, { type ApiClientInitConfig } from './client';
 import type { QueryParamsRetrieve, QueryParamsList, QueryFilter, QueryParams } from './query';
 import type { ResourceTypeLock } from './api';
-import type { InterceptorManager } from './interceptor';
 type ResourceNull = {
     id: null;
 } & ResourceType;
@@ -53,7 +52,6 @@ type ResourcesConfig = Partial<ResourcesInitConfig>;
 declare class ResourceAdapter {
     #private;
     constructor(config: ResourcesInitConfig);
-    get interceptors(): InterceptorManager;
     private localConfig;
     config(config: ResourcesConfig): ResourceAdapter;
     get client(): Readonly<ApiClient>;
@@ -70,10 +68,9 @@ declare abstract class ApiResourceBase<R extends Resource> {
     protected readonly resources: ResourceAdapter;
     constructor(adapter: ResourceAdapter);
     abstract relationship(id: string | ResourceId | null): ResourceRel;
+    protected relationshipOneToOne<RR extends ResourceRel>(id: string | ResourceId | null): RR;
+    protected relationshipOneToMany<RR extends ResourceRel>(...ids: string[]): RR[];
     abstract type(): ResourceTypeLock;
-    parse(resource: string, options?: {
-        ignoreSlug?: boolean;
-    }): R | R[];
     update(resource: ResourceUpdate, params?: QueryParamsRetrieve, options?: ResourcesConfig): Promise<R>;
 }
 declare abstract class ApiResource<R extends Resource> extends ApiResourceBase<R> {

package/lib/esm/resource.js

@@ -1,23 +1,11 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _ResourceAdapter_client, _ResourceAdapter_config;
 import ApiClient from './client';
 import { denormalize, normalize } from './jsonapi';
 import { generateQueryStringParams, isParamsList } from './query';
 import config from './config';
-import { ErrorType, SdkError } from './error';
 import Debug from './debug';
 const debug = Debug('resource');
 class ListResponse extends Array {
+    meta;
     constructor(meta, data) {
         super(...(data || []));
         this.meta = meta;
@@ -33,100 +21,94 @@ class ListResponse extends Array {
     get pageCount() { return this.meta.pageCount; }
 }
 class ResourceAdapter {
+    #client;
+    #config = {};
     constructor(config) {
-        _ResourceAdapter_client.set(this, void 0);
-        _ResourceAdapter_config.set(this, {});
-        __classPrivateFieldSet(this, _ResourceAdapter_client, ApiClient.create(config), "f");
+        this.#client = ApiClient.create(config);
         this.localConfig(config);
     }
-    get interceptors() { return __classPrivateFieldGet(this, _ResourceAdapter_client, "f").interceptors; }
     localConfig(config) {
-        // if (typeof config.xyz !== 'undefined') this.#config.xyz = config.xyz
     }
     config(config) {
         debug('config %o', config);
-        // ResourceAdapter config
         this.localConfig(config);
-        // Client config
-        __classPrivateFieldGet(this, _ResourceAdapter_client, "f").config(config);
+        this.#client.config(config);
         return this;
     }
     get client() {
-        return __classPrivateFieldGet(this, _ResourceAdapter_client, "f");
+        return this.#client;
     }
     async singleton(resource, params, options) {
         debug('singleton: %o, %O, %O', resource, params || {}, options || {});
         const queryParams = generateQueryStringParams(params, resource);
-        if (options === null || options === void 0 ? void 0 : options.params)
-            Object.assign(queryParams, options === null || options === void 0 ? void 0 : options.params);
-        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('get', `${resource.type}`, undefined, { ...options, params: queryParams });
+        if (options?.params)
+            Object.assign(queryParams, options?.params);
+        const res = await this.#client.request('GET', `${resource.type}`, undefined, { ...options, params: queryParams });
         const r = denormalize(res);
         return r;
     }
     async retrieve(resource, params, options) {
         debug('retrieve: %o, %O, %O', resource, params || {}, options || {});
         const queryParams = generateQueryStringParams(params, resource);
-        if (options === null || options === void 0 ? void 0 : options.params)
-            Object.assign(queryParams, options === null || options === void 0 ? void 0 : options.params);
-        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('get', `${resource.type}/${resource.id}`, undefined, { ...options, params: queryParams });
+        if (options?.params)
+            Object.assign(queryParams, options?.params);
+        const res = await this.#client.request('GET', `${resource.type}/${resource.id}`, undefined, { ...options, params: queryParams });
         const r = denormalize(res);
         return r;
     }
     async list(resource, params, options) {
-        var _a, _b;
         debug('list: %o, %O, %O', resource, params || {}, options || {});
         const queryParams = generateQueryStringParams(params, resource);
-        if (options === null || options === void 0 ? void 0 : options.params)
-            Object.assign(queryParams, options === null || options === void 0 ? void 0 : options.params);
-        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('get', `${resource.type}`, undefined, { ...options, params: queryParams });
+        if (options?.params)
+            Object.assign(queryParams, options?.params);
+        const res = await this.#client.request('GET', `${resource.type}`, undefined, { ...options, params: queryParams });
         const r = denormalize(res);
         const meta = {
-            pageCount: Number((_a = res.meta) === null || _a === void 0 ? void 0 : _a.page_count),
-            recordCount: Number((_b = res.meta) === null || _b === void 0 ? void 0 : _b.record_count),
-            currentPage: (params === null || params === void 0 ? void 0 : params.pageNumber) || config.default.pageNumber,
-            recordsPerPage: (params === null || params === void 0 ? void 0 : params.pageSize) || config.default.pageSize
+            pageCount: Number(res.meta?.page_count),
+            recordCount: Number(res.meta?.record_count),
+            currentPage: params?.pageNumber || config.default.pageNumber,
+            recordsPerPage: params?.pageSize || config.default.pageSize
         };
         return new ListResponse(meta, r);
     }
     async create(resource, params, options) {
         debug('create: %o, %O, %O', resource, params || {}, options || {});
         const queryParams = generateQueryStringParams(params, resource);
-        if (options === null || options === void 0 ? void 0 : options.params)
-            Object.assign(queryParams, options === null || options === void 0 ? void 0 : options.params);
+        if (options?.params)
+            Object.assign(queryParams, options?.params);
         const data = normalize(resource);
-        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('post', resource.type, data, { ...options, params: queryParams });
+        const res = await this.#client.request('POST', resource.type, data, { ...options, params: queryParams });
         const r = denormalize(res);
         return r;
     }
     async update(resource, params, options) {
         debug('update: %o, %O, %O', resource, params || {}, options || {});
         const queryParams = generateQueryStringParams(params, resource);
-        if (options === null || options === void 0 ? void 0 : options.params)
-            Object.assign(queryParams, options === null || options === void 0 ? void 0 : options.params);
+        if (options?.params)
+            Object.assign(queryParams, options?.params);
         const data = normalize(resource);
-        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('patch', `${resource.type}/${resource.id}`, data, { ...options, params: queryParams });
+        const res = await this.#client.request('PATCH', `${resource.type}/${resource.id}`, data, { ...options, params: queryParams });
         const r = denormalize(res);
         return r;
     }
     async delete(resource, options) {
         debug('delete: %o, %O', resource, options || {});
-        await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('delete', `${resource.type}/${resource.id}`, undefined, options);
+        await this.#client.request('DELETE', `${resource.type}/${resource.id}`, undefined, options);
     }
     async fetch(resource, path, params, options) {
-        var _a, _b;
         debug('fetch: %o, %O, %O', path, params || {}, options || {});
         const queryParams = generateQueryStringParams(params, resource);
-        if (options === null || options === void 0 ? void 0 : options.params)
-            Object.assign(queryParams, options === null || options === void 0 ? void 0 : options.params);
-        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('get', path, undefined, { ...options, params: queryParams });
+        if (options?.params)
+            Object.assign(queryParams, options?.params);
+        const res = await this.#client.request('GET', path, undefined, { ...options, params: queryParams });
         const r = denormalize(res);
         if (Array.isArray(r)) {
             const p = params;
             const meta = {
-                pageCount: Number((_a = res.meta) === null || _a === void 0 ? void 0 : _a.page_count),
-                recordCount: Number((_b = res.meta) === null || _b === void 0 ? void 0 : _b.record_count),
-                currentPage: (p === null || p === void 0 ? void 0 : p.pageNumber) || config.default.pageNumber,
-                recordsPerPage: (p === null || p === void 0 ? void 0 : p.pageSize) || config.default.pageSize
+                pageCount: Number(res.meta?.page_count),
+                recordCount: Number(res.meta?.record_count),
+                currentPage: p?.pageNumber || config.default.pageNumber,
+                recordsPerPage: p?.pageSize || config.default.pageSize
             };
             return new ListResponse(meta, r);
         }
@@ -134,37 +116,19 @@ class ResourceAdapter {
             return r;
     }
 }
-_ResourceAdapter_client = new WeakMap(), _ResourceAdapter_config = new WeakMap();
 class ApiResourceBase {
+    static TYPE;
+    resources;
     constructor(adapter) {
         debug('new resource instance: %s', this.type());
         this.resources = adapter;
     }
-    parse(resource, options) {
-        var _a;
-        try {
-            const res = JSON.parse(resource);
-            // Resource type always checked
-            const rtype = (_a = res.data) === null || _a === void 0 ? void 0 : _a.type;
-            if (rtype !== this.type())
-                throw new SdkError({ message: `Invalid resource type [${rtype}]`, type: ErrorType.PARSE });
-            // Parse options
-            const { ignoreSlug } = options || {};
-            if (!ignoreSlug) {
-                const links = res.data.links.self;
-                if (!links || !String(links).match(`^${this.resources.client.baseUrl}/${this.type()}/*`))
-                    throw new SdkError({ message: `Resource contains invalid links [${links}]`, type: ErrorType.PARSE });
-            }
-            return denormalize(res);
-        }
-        catch (error) {
-            if (SdkError.isSdkError(error))
-                throw error;
-            else
-                throw new SdkError({ message: `Payload parse error [${error.message}]`, type: ErrorType.PARSE });
-        }
+    relationshipOneToOne(id) {
+        return (((id === null) || (typeof id === 'string')) ? { id, type: this.type() } : { id: id.id, type: this.type() });
+    }
+    relationshipOneToMany(...ids) {
+        return (((ids === null) || (ids.length === 0) || (ids[0] === null)) ? [{ id: null, type: this.type() }] : ids.map(id => { return { id, type: this.type() }; }));
     }
-    // reference, reference_origin and metadata attributes are always updatable
     async update(resource, params, options) {
         return this.resources.update({ ...resource, type: this.type() }, params, options);
     }

package/lib/esm/resources/addresses.d.ts

@@ -97,6 +97,7 @@ declare class Addresses extends ApiResource<Address> {
     versions(addressId: string | Address, params?: QueryParamsList, options?: ResourcesConfig): Promise<ListResponse<Version>>;
     isAddress(resource: any): resource is Address;
     relationship(id: string | ResourceId | null): AddressRel;
+    relationshipToMany(...ids: string[]): AddressRel[];
     type(): AddressType;
 }
 export default Addresses;

package/lib/esm/resources/addresses.js

@@ -1,5 +1,6 @@
 import { ApiResource } from '../resource';
 class Addresses extends ApiResource {
+    static TYPE = 'addresses';
     async create(resource, params, options) {
         return this.resources.create({ ...resource, type: Addresses.TYPE }, params, options);
     }
@@ -29,11 +30,13 @@ class Addresses extends ApiResource {
         return resource.type && (resource.type === Addresses.TYPE);
     }
     relationship(id) {
-        return ((id === null) || (typeof id === 'string')) ? { id, type: Addresses.TYPE } : { id: id.id, type: Addresses.TYPE };
+        return super.relationshipOneToOne(id);
+    }
+    relationshipToMany(...ids) {
+        return super.relationshipOneToMany(...ids);
     }
     type() {
         return Addresses.TYPE;
     }
 }
-Addresses.TYPE = 'addresses';
 export default Addresses;

package/lib/esm/resources/adjustments.d.ts

@@ -36,6 +36,7 @@ declare class Adjustments extends ApiResource<Adjustment> {
     versions(adjustmentId: string | Adjustment, params?: QueryParamsList, options?: ResourcesConfig): Promise<ListResponse<Version>>;
     isAdjustment(resource: any): resource is Adjustment;
     relationship(id: string | ResourceId | null): AdjustmentRel;
+    relationshipToMany(...ids: string[]): AdjustmentRel[];
     type(): AdjustmentType;
 }
 export default Adjustments;

package/lib/esm/resources/adjustments.js

@@ -1,5 +1,6 @@
 import { ApiResource } from '../resource';
 class Adjustments extends ApiResource {
+    static TYPE = 'adjustments';
     async create(resource, params, options) {
         return this.resources.create({ ...resource, type: Adjustments.TYPE }, params, options);
     }
@@ -17,11 +18,13 @@ class Adjustments extends ApiResource {
         return resource.type && (resource.type === Adjustments.TYPE);
     }
     relationship(id) {
-        return ((id === null) || (typeof id === 'string')) ? { id, type: Adjustments.TYPE } : { id: id.id, type: Adjustments.TYPE };
+        return super.relationshipOneToOne(id);
+    }
+    relationshipToMany(...ids) {
+        return super.relationshipOneToMany(...ids);
     }
     type() {
         return Adjustments.TYPE;
     }
 }
-Adjustments.TYPE = 'adjustments';
 export default Adjustments;

package/lib/esm/resources/adyen_gateways.d.ts

@@ -54,6 +54,7 @@ declare class AdyenGateways extends ApiResource<AdyenGateway> {
     adyen_payments(adyenGatewayId: string | AdyenGateway, params?: QueryParamsList, options?: ResourcesConfig): Promise<ListResponse<AdyenPayment>>;
     isAdyenGateway(resource: any): resource is AdyenGateway;
     relationship(id: string | ResourceId | null): AdyenGatewayRel;
+    relationshipToMany(...ids: string[]): AdyenGatewayRel[];
     type(): AdyenGatewayType;
 }
 export default AdyenGateways;

package/lib/esm/resources/adyen_gateways.js

@@ -1,5 +1,6 @@
 import { ApiResource } from '../resource';
 class AdyenGateways extends ApiResource {
+    static TYPE = 'adyen_gateways';
     async create(resource, params, options) {
         return this.resources.create({ ...resource, type: AdyenGateways.TYPE }, params, options);
     }
@@ -25,11 +26,13 @@ class AdyenGateways extends ApiResource {
         return resource.type && (resource.type === AdyenGateways.TYPE);
     }
     relationship(id) {
-        return ((id === null) || (typeof id === 'string')) ? { id, type: AdyenGateways.TYPE } : { id: id.id, type: AdyenGateways.TYPE };
+        return super.relationshipOneToOne(id);
+    }
+    relationshipToMany(...ids) {
+        return super.relationshipOneToMany(...ids);
     }
     type() {
         return AdyenGateways.TYPE;
     }
 }
-AdyenGateways.TYPE = 'adyen_gateways';
 export default AdyenGateways;