@commercelayer/sdk 6.0.0-alfa.1 → 6.0.0-alfa.11

package/lib/esm/debug.js

@@ -1,35 +1,14 @@
-/* Nope debugger */
 const debuggerFunction = (_pattern, ..._args) => {
-    // console.log(_pattern)
 };
 let debuggerFactory = (_namespace) => debuggerFunction;
-/* Try loading 'debug' module */
 try {
     const debugModule = require('debug');
     if (debugModule && (typeof debugModule === 'function'))
         debuggerFactory = debugModule;
 }
 catch (error) {
-    //
 }
 const debugPrefix = 'clsdk';
-/* Retrieve the name of the caller 'module' */
-/*
-const caller = (): string => {
-
-    const err = new Error()
-
-    Error.prepareStackTrace = (_, stack) => stack
-    const stack = err.stack as unknown as NodeJS.CallSite[]
-    Error.prepareStackTrace = undefined
-
-    const fileName = stack[2].getFileName() || '/'
-
-    return fileName.replace(/^.*[\\/]/, '').replace('.ts', '')
-
-}
-*/
-/* Return a debugger for the defined namespace */
 const debug = (namespace) => {
     return debuggerFactory(`${debugPrefix}:${namespace}`);
 };

package/lib/esm/error.d.ts

@@ -1,10 +1,10 @@
 declare enum ErrorType {
-    CLIENT = "client",// Error instantiating the client
-    REQUEST = "request",// Error preparing API request
-    RESPONSE = "response",// Error response from API
-    CANCEL = "cancel",// Forced request abort using interceptor
-    PARSE = "parse",// Error parsing API resource
-    GENERIC = "generic"
+    CLIENT = "client",
+    REQUEST = "request",
+    RESPONSE = "response",
+    CANCEL = "cancel",
+    PARSE = "parse",
+    TIMEOUT = "timeout"
 }
 declare class SdkError extends Error {
     static NAME: string;
@@ -12,7 +12,6 @@ declare class SdkError extends Error {
     type: ErrorType;
     code?: string;
     source?: Error;
-    request?: any;
     constructor(error: {
         message: string;
         type?: ErrorType;

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,7 +6,7 @@ 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';
@@ -16,11 +16,10 @@ class SdkError extends Error {
     type;
     code;
     source;
-    request;
     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;
     }
 }
 class ApiError extends SdkError {
@@ -33,42 +32,47 @@ class ApiError extends SdkError {
     statusText;
     constructor(error) {
         super({ ...error, type: ErrorType.RESPONSE });
-        this.name = ApiError.NAME; // this.constructor.name
+        this.name = ApiError.NAME;
     }
     first() {
         return (this.errors?.length > 0) ? this.errors[0] : undefined;
     }
 }
+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 ResponseInterceptor = (response: ResponseObj) => ResponseObj;
+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 ErrorInterceptor = (error: ErrorObj) => ErrorObj;
+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

@@ -1,7 +1,7 @@
 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)
@@ -24,7 +24,7 @@ const findIncluded = (rel, included = []) => {
     });
     return inc || rel;
 };
-const denormalizeResource = (res, included) => {
+const denormalizeResource = (res, included, chain = []) => {
     debug('denormalize resource: %O, %o', res, included || {});
     if (!res)
         return res;
@@ -37,10 +37,14 @@ const denormalizeResource = (res, included) => {
         Object.keys(res.relationships).forEach(key => {
             const rel = res.relationships[key].data;
             if (rel) {
-                if (Array.isArray(rel))
-                    resource[key] = rel.map((r) => denormalizeResource(findIncluded(r, included), included));
-                else
-                    resource[key] = denormalizeResource(findIncluded(rel, included), included);
+                if (chain.filter(r => (r.id === rel.id) && (r.type === rel.type)).length >= config.jsonapi.maxResourceIncluded)
+                    resource[key] = rel;
+                else {
+                    if (Array.isArray(rel))
+                        resource[key] = rel.map((r) => denormalizeResource(findIncluded(r, included), included, [...chain, r]));
+                    else
+                        resource[key] = denormalizeResource(findIncluded(rel, included), included, [...chain, rel]);
+                }
             }
             else if (rel === null)
                 resource[key] = null;
@@ -48,7 +52,6 @@ const denormalizeResource = (res, included) => {
     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

@@ -1,5 +1,5 @@
 import type { ResourceType } from "./resource";
-type QueryFilter = Record<string, string | number | boolean | object>;
+type QueryFilter = Record<string, string | number | boolean | object | Array<string | number>>;
 interface QueryParamsRetrieve {
     include?: string[];
     fields?: string[] | Record<string, string[]>;
@@ -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,8 @@
+import { ErrorType, SdkError } from "./error";
 import Debug from './debug';
 const debug = Debug('query');
+const arrayFilters = ['_any', '_all', '_in'];
+const objectFilters = ['_jcont'];
 const isParamsList = (params) => {
     return params && (params.filters || params.pageNumber || params.pageSize || params.sort);
 };
@@ -8,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 };
@@ -20,26 +21,42 @@ 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]) => {
-                qp[`filter[q][${p}]`] = (typeof v === 'object') ? JSON.stringify(v) : String(v);
+                const filter = p.substring(p.lastIndexOf('_'));
+                let val;
+                if (Array.isArray(v)) {
+                    if (!arrayFilters.includes(filter))
+                        throw new SdkError({ message: `Wrong ${filter} filter: Array value is supported only for the following filters: ${arrayFilters.join(', ')}`, type: ErrorType.REQUEST });
+                    val = v.join(',');
+                }
+                else if (typeof v === 'object') {
+                    if (!objectFilters.includes(filter))
+                        throw new SdkError({ message: `Wrong ${filter} filter: Object value is supported only for the following filters: ${objectFilters.join(', ')}`, type: ErrorType.REQUEST });
+                    val = JSON.stringify(v);
+                }
+                else
+                    val = String(v);
+                qp[`filter[q][${p}]`] = val;
             });
         }
     }
     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 { type ApiClientInitConfig } from './client';
+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,9 +52,9 @@ type ResourcesConfig = Partial<ResourcesInitConfig>;
 declare class ResourceAdapter {
     #private;
     constructor(config: ResourcesInitConfig);
-    get interceptors(): InterceptorManager;
     private localConfig;
     config(config: ResourcesConfig): ResourceAdapter;
+    get client(): Readonly<ApiClient>;
     singleton<R extends Resource>(resource: ResourceType, params?: QueryParamsRetrieve, options?: ResourcesConfig): Promise<R>;
     retrieve<R extends Resource>(resource: ResourceId, params?: QueryParamsRetrieve, options?: ResourcesConfig): Promise<R>;
     list<R extends Resource>(resource: ResourceType, params?: QueryParamsList, options?: ResourcesConfig): Promise<ListResponse<R>>;
@@ -69,8 +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): 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

@@ -2,7 +2,6 @@ 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 {
@@ -28,29 +27,23 @@ class ResourceAdapter {
         this.#client = ApiClient.create(config);
         this.localConfig(config);
     }
-    get interceptors() { return this.#client.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
         this.#client.config(config);
         return this;
     }
-    /*
-    get clientInstance(): ApiClient {
-        return this.#client
+    get client() {
+        return this.#client;
     }
-    */
     async singleton(resource, params, options) {
         debug('singleton: %o, %O, %O', resource, params || {}, options || {});
         const queryParams = generateQueryStringParams(params, resource);
         if (options?.params)
             Object.assign(queryParams, options?.params);
-        const res = await this.#client.request('get', `${resource.type}`, undefined, { ...options, params: queryParams });
+        const res = await this.#client.request('GET', `${resource.type}`, undefined, { ...options, params: queryParams });
         const r = denormalize(res);
         return r;
     }
@@ -59,7 +52,7 @@ class ResourceAdapter {
         const queryParams = generateQueryStringParams(params, resource);
         if (options?.params)
             Object.assign(queryParams, options?.params);
-        const res = await this.#client.request('get', `${resource.type}/${resource.id}`, undefined, { ...options, params: queryParams });
+        const res = await this.#client.request('GET', `${resource.type}/${resource.id}`, undefined, { ...options, params: queryParams });
         const r = denormalize(res);
         return r;
     }
@@ -68,7 +61,7 @@ class ResourceAdapter {
         const queryParams = generateQueryStringParams(params, resource);
         if (options?.params)
             Object.assign(queryParams, options?.params);
-        const res = await this.#client.request('get', `${resource.type}`, undefined, { ...options, params: queryParams });
+        const res = await this.#client.request('GET', `${resource.type}`, undefined, { ...options, params: queryParams });
         const r = denormalize(res);
         const meta = {
             pageCount: Number(res.meta?.page_count),
@@ -84,7 +77,7 @@ class ResourceAdapter {
         if (options?.params)
             Object.assign(queryParams, options?.params);
         const data = normalize(resource);
-        const res = await this.#client.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;
     }
@@ -94,20 +87,20 @@ class ResourceAdapter {
         if (options?.params)
             Object.assign(queryParams, options?.params);
         const data = normalize(resource);
-        const res = await this.#client.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 this.#client.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) {
         debug('fetch: %o, %O, %O', path, params || {}, options || {});
         const queryParams = generateQueryStringParams(params, resource);
         if (options?.params)
             Object.assign(queryParams, options?.params);
-        const res = await this.#client.request('get', path, undefined, { ...options, params: queryParams });
+        const res = await this.#client.request('GET', path, undefined, { ...options, params: queryParams });
         const r = denormalize(res);
         if (Array.isArray(r)) {
             const p = params;
@@ -130,21 +123,12 @@ class ApiResourceBase {
         debug('new resource instance: %s', this.type());
         this.resources = adapter;
     }
-    parse(resource) {
-        try {
-            const res = JSON.parse(resource);
-            if (res.data?.type !== this.type())
-                throw new SdkError({ message: `Invalid resource type [${res.data?.type}]`, 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

@@ -30,7 +30,10 @@ 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;

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

@@ -18,7 +18,10 @@ 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;

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

@@ -26,7 +26,10 @@ 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;

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

@@ -45,6 +45,7 @@ declare class AdyenPayments extends ApiResource<AdyenPayment> {
     _details(id: string | AdyenPayment, params?: QueryParamsRetrieve, options?: ResourcesConfig): Promise<AdyenPayment>;
     isAdyenPayment(resource: any): resource is AdyenPayment;
     relationship(id: string | ResourceId | null): AdyenPaymentRel;
+    relationshipToMany(...ids: string[]): AdyenPaymentRel[];
     type(): AdyenPaymentType;
 }
 export default AdyenPayments;