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

package/lib/cjs/debug.js

@@ -1,37 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-/* 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/cjs/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/cjs/error.js

@@ -1,10 +1,7 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleError = exports.ErrorType = exports.ApiError = exports.SdkError = void 0;
-const axios_1 = __importDefault(require("axios"));
+const fetch_1 = require("./fetch");
 var ErrorType;
 (function (ErrorType) {
     ErrorType["CLIENT"] = "client";
@@ -12,7 +9,7 @@ var ErrorType;
     ErrorType["RESPONSE"] = "response";
     ErrorType["CANCEL"] = "cancel";
     ErrorType["PARSE"] = "parse";
-    ErrorType["GENERIC"] = "generic";
+    ErrorType["TIMEOUT"] = "timeout";
 })(ErrorType || (exports.ErrorType = ErrorType = {}));
 class SdkError extends Error {
     static isSdkError(error) {
@@ -20,8 +17,8 @@ class SdkError extends Error {
     }
     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;
     }
 }
 exports.SdkError = SdkError;
@@ -33,7 +30,7 @@ class ApiError extends SdkError {
     constructor(error) {
         super({ ...error, type: ErrorType.RESPONSE });
         this.errors = [];
-        this.name = ApiError.NAME; // this.constructor.name
+        this.name = ApiError.NAME;
     }
     first() {
         return (this.errors?.length > 0) ? this.errors[0] : undefined;
@@ -41,36 +38,41 @@ class ApiError extends SdkError {
 }
 exports.ApiError = ApiError;
 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_1.default.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 (fetch_1.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 (axios_1.default.isCancel(error))
+    else if (isRequestError(error)) {
+        sdkError.type = ErrorType.REQUEST;
+    }
+    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;
 };
 exports.handleError = handleError;

package/lib/cjs/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/cjs/fetch.js

@@ -0,0 +1,67 @@
+"use strict";
+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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _FetchError_errors, _FetchError_status, _FetchError_statusText;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchURL = exports.FetchError = void 0;
+const debug_1 = __importDefault(require("./debug"));
+const debug = (0, debug_1.default)('fetch');
+class FetchError extends Error {
+    constructor(status, statusText, body) {
+        super(statusText);
+        _FetchError_errors.set(this, void 0);
+        _FetchError_status.set(this, void 0);
+        _FetchError_statusText.set(this, void 0);
+        __classPrivateFieldSet(this, _FetchError_status, status, "f");
+        __classPrivateFieldSet(this, _FetchError_statusText, statusText, "f");
+        if (body)
+            __classPrivateFieldSet(this, _FetchError_errors, body.errors, "f");
+    }
+    get errors() { return __classPrivateFieldGet(this, _FetchError_errors, "f"); }
+    get status() { return __classPrivateFieldGet(this, _FetchError_status, "f"); }
+    get statusText() { return __classPrivateFieldGet(this, _FetchError_statusText, "f"); }
+}
+exports.FetchError = FetchError;
+_FetchError_errors = new WeakMap(), _FetchError_status = new WeakMap(), _FetchError_statusText = new WeakMap();
+FetchError.isFetchError = (error) => {
+    return error instanceof FetchError;
+};
+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;
+};
+exports.fetchURL = fetchURL;

package/lib/cjs/index.js

@@ -4,10 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CommerceLayerStatic = exports.CommerceLayer = exports.default = void 0;
-// SDK
 var commercelayer_1 = require("./commercelayer");
 Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(commercelayer_1).default; } });
 Object.defineProperty(exports, "CommerceLayer", { enumerable: true, get: function () { return commercelayer_1.CommerceLayer; } });
-// Commerce Layer static functions
 var static_1 = require("./static");
 Object.defineProperty(exports, "CommerceLayerStatic", { enumerable: true, get: function () { return static_1.CommerceLayerStatic; } });

package/lib/cjs/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/cjs/jsonapi.js

@@ -5,9 +5,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalize = exports.denormalize = void 0;
 const common_1 = require("./common");
+const config_1 = __importDefault(require("./config"));
 const debug_1 = __importDefault(require("./debug"));
 const debug = (0, debug_1.default)('jsonapi');
-// DENORMALIZATION
 const denormalize = (response) => {
     let denormalizedResponse;
     if (response.links)
@@ -31,7 +31,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;
@@ -44,10 +44,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_1.default.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;
@@ -55,7 +59,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/cjs/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/cjs/model.js

@@ -1,3 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-// ##__MODEL_TYPES_STOP__##

package/lib/cjs/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/cjs/query.js

@@ -3,9 +3,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isParamsList = exports.generateQueryStringParams = void 0;
+exports.generateSearchString = exports.isParamsList = exports.generateQueryStringParams = void 0;
+const error_1 = require("./error");
 const debug_1 = __importDefault(require("./debug"));
 const debug = (0, debug_1.default)('query');
+const arrayFilters = ['_any', '_all', '_in'];
+const objectFilters = ['_jcont'];
 const isParamsList = (params) => {
     return params && (params.filters || params.pageNumber || params.pageSize || params.sort);
 };
@@ -15,10 +18,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 };
@@ -27,22 +28,33 @@ 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 error_1.SdkError({ message: `Wrong ${filter} filter: Array value is supported only for the following filters: ${arrayFilters.join(', ')}`, type: error_1.ErrorType.REQUEST });
+                    val = v.join(',');
+                }
+                else if (typeof v === 'object') {
+                    if (!objectFilters.includes(filter))
+                        throw new error_1.SdkError({ message: `Wrong ${filter} filter: Object value is supported only for the following filters: ${objectFilters.join(', ')}`, type: error_1.ErrorType.REQUEST });
+                    val = JSON.stringify(v);
+                }
+                else
+                    val = String(v);
+                qp[`filter[q][${p}]`] = val;
             });
         }
     }
@@ -50,3 +62,9 @@ const generateQueryStringParams = (params, res) => {
     return qp;
 };
 exports.generateQueryStringParams = generateQueryStringParams;
+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('&')}`;
+};
+exports.generateSearchString = generateSearchString;

package/lib/cjs/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/cjs/resource.js

@@ -20,7 +20,6 @@ const client_1 = __importDefault(require("./client"));
 const jsonapi_1 = require("./jsonapi");
 const query_1 = require("./query");
 const config_1 = __importDefault(require("./config"));
-const error_1 = require("./error");
 const debug_1 = __importDefault(require("./debug"));
 const debug = (0, debug_1.default)('resource');
 class ListResponse extends Array {
@@ -45,29 +44,23 @@ class ResourceAdapter {
         __classPrivateFieldSet(this, _ResourceAdapter_client, client_1.default.create(config), "f");
         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);
         return this;
     }
-    /*
-    get clientInstance(): ApiClient {
-        return this.#client
+    get client() {
+        return __classPrivateFieldGet(this, _ResourceAdapter_client, "f");
     }
-    */
     async singleton(resource, params, options) {
         debug('singleton: %o, %O, %O', resource, params || {}, options || {});
         const queryParams = (0, query_1.generateQueryStringParams)(params, resource);
         if (options?.params)
             Object.assign(queryParams, options?.params);
-        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('get', `${resource.type}`, undefined, { ...options, params: queryParams });
+        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('GET', `${resource.type}`, undefined, { ...options, params: queryParams });
         const r = (0, jsonapi_1.denormalize)(res);
         return r;
     }
@@ -76,7 +69,7 @@ class ResourceAdapter {
         const queryParams = (0, query_1.generateQueryStringParams)(params, resource);
         if (options?.params)
             Object.assign(queryParams, options?.params);
-        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('get', `${resource.type}/${resource.id}`, undefined, { ...options, params: queryParams });
+        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('GET', `${resource.type}/${resource.id}`, undefined, { ...options, params: queryParams });
         const r = (0, jsonapi_1.denormalize)(res);
         return r;
     }
@@ -85,7 +78,7 @@ class ResourceAdapter {
         const queryParams = (0, query_1.generateQueryStringParams)(params, resource);
         if (options?.params)
             Object.assign(queryParams, options?.params);
-        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('get', `${resource.type}`, undefined, { ...options, params: queryParams });
+        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('GET', `${resource.type}`, undefined, { ...options, params: queryParams });
         const r = (0, jsonapi_1.denormalize)(res);
         const meta = {
             pageCount: Number(res.meta?.page_count),
@@ -101,7 +94,7 @@ class ResourceAdapter {
         if (options?.params)
             Object.assign(queryParams, options?.params);
         const data = (0, jsonapi_1.normalize)(resource);
-        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('post', resource.type, data, { ...options, params: queryParams });
+        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('POST', resource.type, data, { ...options, params: queryParams });
         const r = (0, jsonapi_1.denormalize)(res);
         return r;
     }
@@ -111,20 +104,20 @@ class ResourceAdapter {
         if (options?.params)
             Object.assign(queryParams, options?.params);
         const data = (0, jsonapi_1.normalize)(resource);
-        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('patch', `${resource.type}/${resource.id}`, data, { ...options, params: queryParams });
+        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('PATCH', `${resource.type}/${resource.id}`, data, { ...options, params: queryParams });
         const r = (0, jsonapi_1.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 __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('DELETE', `${resource.type}/${resource.id}`, undefined, options);
     }
     async fetch(resource, path, params, options) {
         debug('fetch: %o, %O, %O', path, params || {}, options || {});
         const queryParams = (0, query_1.generateQueryStringParams)(params, resource);
         if (options?.params)
             Object.assign(queryParams, options?.params);
-        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('get', path, undefined, { ...options, params: queryParams });
+        const res = await __classPrivateFieldGet(this, _ResourceAdapter_client, "f").request('GET', path, undefined, { ...options, params: queryParams });
         const r = (0, jsonapi_1.denormalize)(res);
         if (Array.isArray(r)) {
             const p = params;
@@ -146,21 +139,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 error_1.SdkError({ message: `Invalid resource type [${res.data?.type}]`, type: error_1.ErrorType.PARSE });
-            return (0, jsonapi_1.denormalize)(res);
-        }
-        catch (error) {
-            if (error_1.SdkError.isSdkError(error))
-                throw error;
-            else
-                throw new error_1.SdkError({ message: `Payload parse error [${error.message}]`, type: error_1.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/cjs/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/cjs/resources/addresses.js

@@ -31,7 +31,10 @@ class Addresses extends resource_1.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/cjs/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;