@acmekit/js-sdk 2.13.1

package/dist/client.js

@@ -0,0 +1,315 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Client = exports.FetchError = exports.LOCALE_STORAGE_KEY = exports.PUBLISHABLE_KEY_HEADER = void 0;
+const fetch_event_stream_1 = require("fetch-event-stream");
+const qs_1 = require("qs");
+exports.PUBLISHABLE_KEY_HEADER = "x-publishable-api-key";
+exports.LOCALE_STORAGE_KEY = "acmekit_locale";
+// We want to explicitly retrieve the base URL instead of relying on relative paths that differ in behavior between browsers.
+const getBaseUrl = (passedBaseUrl) => {
+    if (typeof window === "undefined") {
+        return passedBaseUrl;
+    }
+    // If the passed base URL is empty or "/", we use the current origin from the browser.
+    if (passedBaseUrl === "" || passedBaseUrl === "/") {
+        return window.location.origin;
+    }
+    return passedBaseUrl;
+};
+const hasStorage = (storage) => {
+    if (typeof window !== "undefined") {
+        return storage in window;
+    }
+    return false;
+};
+const toBase64 = (str) => {
+    if (typeof window !== "undefined") {
+        return window.btoa(str);
+    }
+    return Buffer.from(str).toString("base64");
+};
+const sanitizeHeaders = (headers) => {
+    return {
+        ...Object.fromEntries(headers.entries()),
+        authorization: "<REDACTED>",
+    };
+};
+const normalizeRequest = (init, headers, config) => {
+    let body = init?.body;
+    if (body && headers.get("content-type")?.includes("application/json")) {
+        body = JSON.stringify(body);
+    }
+    // "credentials" is not supported in some environments (eg. on the backend), and it might throw an exception if the field is set.
+    const isFetchCredentialsSupported = "credentials" in Request.prototype;
+    // Oftentimes the server will be on a different origin, so we want to default to include
+    // Note that the cookie's SameSite attribute takes precedence over this setting.
+    const credentials = config.auth?.type === "session"
+        ? config.auth?.fetchCredentials || "include"
+        : "omit";
+    return {
+        ...init,
+        headers,
+        credentials: isFetchCredentialsSupported ? credentials : undefined,
+        ...(body ? { body: body } : {}),
+    };
+};
+const normalizeResponse = async (resp, reqHeaders) => {
+    if (resp.status >= 300) {
+        const jsonError = (await resp.json().catch(() => ({})));
+        throw new FetchError(jsonError.message ?? resp.statusText, resp.statusText, resp.status);
+    }
+    // If we requested JSON, we try to parse the response. Otherwise, we return the raw response.
+    const isJsonRequest = reqHeaders.get("accept")?.includes("application/json");
+    return isJsonRequest ? await resp.json() : resp;
+};
+class FetchError extends Error {
+    constructor(message, statusText, status) {
+        super(message);
+        this.statusText = statusText;
+        this.status = status;
+    }
+}
+exports.FetchError = FetchError;
+class Client {
+    get locale() {
+        if (hasStorage("localStorage")) {
+            const storedLocale = window.localStorage.getItem(exports.LOCALE_STORAGE_KEY);
+            if (storedLocale) {
+                return storedLocale;
+            }
+        }
+        return this.locale_;
+    }
+    constructor(config) {
+        this.DEFAULT_JWT_STORAGE_KEY = "acmekit_auth_token";
+        this.token = "";
+        this.locale_ = "";
+        this.getApiKeyHeader_ = () => {
+            return this.config.apiKey
+                ? { Authorization: "Basic " + toBase64(this.config.apiKey + ":") }
+                : {};
+        };
+        this.getPublishableKeyHeader_ = () => {
+            return this.config.publishableKey
+                ? { [exports.PUBLISHABLE_KEY_HEADER]: this.config.publishableKey }
+                : {};
+        };
+        this.getTokenStorageInfo_ = () => {
+            const hasLocal = hasStorage("localStorage");
+            const hasSession = hasStorage("sessionStorage");
+            const hasCustom = Boolean(this.config.auth?.storage);
+            const storageMethod = this.config.auth?.jwtTokenStorageMethod ||
+                (hasLocal ? "local" : "nostore");
+            const storageKey = this.config.auth?.jwtTokenStorageKey || this.DEFAULT_JWT_STORAGE_KEY;
+            if (!hasLocal && storageMethod === "local") {
+                this.throwError_("Local JWT storage is only available in the browser");
+            }
+            if (!hasSession && storageMethod === "session") {
+                this.throwError_("Session JWT storage is only available in the browser");
+            }
+            if (!hasCustom && storageMethod === "custom") {
+                this.throwError_("Custom storage was not provided in the config");
+            }
+            return {
+                storageMethod,
+                storageKey,
+            };
+        };
+        this.config = { ...config, baseUrl: getBaseUrl(config.baseUrl) };
+        const logger = config.logger || {
+            error: console.error,
+            warn: console.warn,
+            info: console.info,
+            debug: console.debug,
+        };
+        this.logger = {
+            ...logger,
+            debug: config.debug ? logger.debug : () => { },
+        };
+        if (hasStorage("localStorage")) {
+            this.locale_ = window.localStorage.getItem(exports.LOCALE_STORAGE_KEY) || "";
+        }
+        this.fetch_ = this.initClient();
+    }
+    setLocale(locale) {
+        if (!window) {
+            this.logger.warn("setLocale is not available in the server environment. Please set the locale directly through the 'x-acmekit-locale' header.");
+            return;
+        }
+        if (hasStorage("localStorage")) {
+            window.localStorage.setItem(exports.LOCALE_STORAGE_KEY, locale);
+        }
+        this.locale_ = locale;
+    }
+    /**
+     * `fetch` closely follows (and uses under the hood) the native `fetch` API. There are, however, few key differences:
+     * - Non 2xx statuses throw a `FetchError` with the status code as the `status` property, rather than resolving the promise
+     * - You can pass `body` and `query` as objects, and they will be encoded and stringified.
+     * - The response gets parsed as JSON if the `accept` header is set to `application/json`, otherwise the raw Response object is returned
+     *
+     * Since the response is dynamically determined, we cannot know if it is JSON or not. Therefore, it is important to pass `Response` as the return type
+     *
+     * @param input: FetchInput
+     * @param init: FetchArgs
+     * @returns Promise<T>
+     */
+    fetch(input, init) {
+        return this.fetch_(input, init);
+    }
+    /**
+     * `fetchStream` is a helper method to deal with server-sent events. It returns an object with a stream and an abort function.
+     * It follows a very similar interface to `fetch`, with the return value being an async generator.
+     * The stream is an async generator that yields `ServerSentEventMessage` objects, which contains the event name, stringified data, and few other properties.
+     * The caller is responsible for handling `disconnect` events and aborting the stream. The caller is also responsible for parsing the data field.
+     *
+     * @param input: FetchInput
+     * @param init: FetchArgs
+     * @returns FetchStreamResponse
+     */
+    async fetchStream(input, init) {
+        const abortController = new AbortController();
+        const abortFunc = abortController.abort.bind(abortController);
+        let res = await this.fetch_(input, {
+            ...init,
+            signal: abortController.signal,
+            headers: { ...init?.headers, accept: "text/event-stream" },
+        });
+        if (res.ok) {
+            return { stream: (0, fetch_event_stream_1.events)(res, abortController.signal), abort: abortFunc };
+        }
+        return { stream: null, abort: abortFunc };
+    }
+    async setToken(token) {
+        await this.setToken_(token);
+    }
+    async getToken() {
+        return await this.getToken_();
+    }
+    async clearToken() {
+        await this.clearToken_();
+    }
+    async clearToken_() {
+        const { storageMethod, storageKey } = this.getTokenStorageInfo_();
+        switch (storageMethod) {
+            case "local": {
+                window.localStorage.removeItem(storageKey);
+                break;
+            }
+            case "session": {
+                window.sessionStorage.removeItem(storageKey);
+                break;
+            }
+            case "custom": {
+                await this.config.auth?.storage?.removeItem(storageKey);
+                break;
+            }
+            case "memory": {
+                this.token = "";
+                break;
+            }
+        }
+    }
+    initClient() {
+        const defaultHeaders = new Headers({
+            "content-type": "application/json",
+            accept: "application/json",
+            ...this.getApiKeyHeader_(),
+            ...this.getPublishableKeyHeader_(),
+        });
+        this.logger.debug("Initiating AcmeKit client with default headers:\n", `${JSON.stringify(sanitizeHeaders(defaultHeaders), null, 2)}\n`);
+        return async (input, init) => {
+            // We always want to fetch the up-to-date JWT token before firing off a request.
+            const headers = new Headers(defaultHeaders);
+            if (this.locale) {
+                headers.set("x-acmekit-locale", this.locale);
+            }
+            const customHeaders = {
+                "x-acmekit-locale": this.locale,
+                ...this.config.globalHeaders,
+                ...(await this.getJwtHeader_()),
+                ...init?.headers,
+            };
+            // We use `headers.set` in order to ensure headers are overwritten in a case-insensitive manner.
+            Object.entries(customHeaders).forEach(([key, value]) => {
+                if (value === null) {
+                    headers.delete(key);
+                }
+                else {
+                    headers.set(key, value);
+                }
+            });
+            let normalizedInput = input;
+            if (input instanceof URL || typeof input === "string") {
+                const baseUrl = new URL(this.config.baseUrl);
+                const fullPath = `${baseUrl.pathname.replace(/\/$/, "")}/${input
+                    .toString()
+                    .replace(/^\//, "")}`;
+                normalizedInput = new URL(fullPath, baseUrl.origin);
+                if (init?.query) {
+                    const params = Object.fromEntries(normalizedInput.searchParams.entries());
+                    const stringifiedQuery = (0, qs_1.stringify)({ ...params, ...init.query }, { skipNulls: true });
+                    normalizedInput.search = stringifiedQuery;
+                }
+            }
+            this.logger.debug("Performing request to:\n", `URL: ${normalizedInput.toString()}\n`, `Headers: ${JSON.stringify(sanitizeHeaders(headers), null, 2)}\n`);
+            // Any non-request errors (eg. invalid JSON in the response) will be thrown as-is.
+            return await fetch(normalizedInput, normalizeRequest(init, headers, this.config)).then((resp) => {
+                this.logger.debug(`Received response with status ${resp.status}\n`);
+                return normalizeResponse(resp, headers);
+            });
+        };
+    }
+    async getJwtHeader_() {
+        // If the user has requested for session storage, we don't want to send the JWT token in the header.
+        if (this.config.auth?.type === "session") {
+            return {};
+        }
+        const token = await this.getToken_();
+        return token ? { Authorization: `Bearer ${token}` } : {};
+    }
+    async setToken_(token) {
+        const { storageMethod, storageKey } = this.getTokenStorageInfo_();
+        switch (storageMethod) {
+            case "local": {
+                window.localStorage.setItem(storageKey, token);
+                break;
+            }
+            case "session": {
+                window.sessionStorage.setItem(storageKey, token);
+                break;
+            }
+            case "custom": {
+                await this.config.auth?.storage?.setItem(storageKey, token);
+                break;
+            }
+            case "memory": {
+                this.token = token;
+                break;
+            }
+        }
+    }
+    async getToken_() {
+        const { storageMethod, storageKey } = this.getTokenStorageInfo_();
+        switch (storageMethod) {
+            case "local": {
+                return window.localStorage.getItem(storageKey);
+            }
+            case "session": {
+                return window.sessionStorage.getItem(storageKey);
+            }
+            case "custom": {
+                return await this.config.auth?.storage?.getItem(storageKey);
+            }
+            case "memory": {
+                return this.token;
+            }
+        }
+        return null;
+    }
+    throwError_(message) {
+        this.logger.error(message);
+        throw new Error(message);
+    }
+}
+exports.Client = Client;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/esm/admin/api-key.d.ts

@@ -0,0 +1,164 @@
+import { HttpTypes } from "@acmekit/types";
+import { Client } from "../client";
+import { ClientHeaders } from "../types";
+export declare class ApiKey {
+    /**
+     * @ignore
+     */
+    private client;
+    /**
+     * @ignore
+     */
+    constructor(client: Client);
+    /**
+     * This methods retrieves a paginated list of API keys. It sends a request to the
+     * [List API Keys](https://docs.acmekit.com/api/admin#api-keys_getapikeys) API route.
+     *
+     * @param queryParams - Filters and pagination configurations.
+     * @param headers - Headers to pass in the request.
+     * @returns The paginated list of API keys.
+     *
+     * @example
+     * To retrieve the list of API keys:
+     *
+     * ```ts
+     * sdk.admin.apiKey.list()
+     * .then(({ api_keys, count, limit, offset }) => {
+     *   console.log(api_keys)
+     * })
+     * ```
+     *
+     * To configure the pagination, pass the `limit` and `offset` query parameters.
+     *
+     * For example, to retrieve only 10 items and skip 10 items:
+     *
+     * ```ts
+     * sdk.admin.apiKey.list({
+     *   limit: 10,
+     *   offset: 10
+     * })
+     * .then(({ api_keys, count, limit, offset }) => {
+     *   console.log(api_keys)
+     * })
+     * ```
+     *
+     * Using the `fields` query parameter, you can specify the fields and relations to retrieve
+     * in each API key:
+     *
+     * ```ts
+     * sdk.admin.apiKey.list({
+     *   fields: "id,*sales_channels"
+     * })
+     * .then(({ api_keys, count, limit, offset }) => {
+     *   console.log(api_keys)
+     * })
+     * ```
+     *
+     * Learn more about the `fields` property in the [API reference](https://docs.acmekit.com/api/store#select-fields-and-relations).
+     */
+    list(queryParams?: HttpTypes.AdminGetApiKeysParams, headers?: ClientHeaders): Promise<HttpTypes.AdminApiKeyListResponse>;
+    /**
+     * This method creates an API key. It sends a request to the [Create API Key](https://docs.acmekit.com/api/admin#api-keys_postapikeys)
+     * API route.
+     *
+     * @param body - The API key's details.
+     * @param query - Configure the fields to retrieve in the created API key.
+     * @param headers - Headers to pass in the request
+     * @returns The created API key
+     *
+     * @example
+     * sdk.admin.apiKey.create({
+     *   title: "Development",
+     *   type: "publishable"
+     * })
+     * .then(({ api_key }) => {
+     *   console.log(api_key)
+     * })
+     */
+    create(body: HttpTypes.AdminCreateApiKey, query?: HttpTypes.AdminGetApiKeysParams, headers?: ClientHeaders): Promise<HttpTypes.AdminApiKeyResponse>;
+    /**
+     * This method revokes an API key. It sends a request to the
+     * [Revoke API Key](https://docs.acmekit.com/api/admin#api-keys_postapikeysidrevoke) API route.
+     *
+     * @param id - The API key's ID.
+     * @param headers - Headers to pass in the request.
+     * @returns The API key's details.
+     *
+     * @example
+     * sdk.admin.apiKey.revoke("apk_123")
+     * .then(({ api_key }) => {
+     *   console.log(api_key)
+     * })
+     */
+    revoke(id: string, headers?: ClientHeaders): Promise<HttpTypes.AdminApiKeyResponse>;
+    /**
+     * This method retrieves an API key's details. It sends a request to the
+     * [Get API key](https://docs.acmekit.com/api/admin#api-keys_getapikeysid) API route.
+     *
+     * @param id - The API key's ID.
+     * @param headers - Headers to pass in the request.
+     * @returns The API key's details.
+     *
+     * @example
+     * sdk.admin.apiKey.retrieve("apk_123")
+     * .then(({ api_key }) => {
+     *   console.log(api_key)
+     * })
+     */
+    retrieve(id: string, headers?: ClientHeaders): Promise<HttpTypes.AdminApiKeyResponse>;
+    /**
+     * This method updates an API key's details. It sends a request to the
+     * [Update API Key](https://docs.acmekit.com/api/admin#api-keys_postapikeysid) API route.
+     *
+     * @param id - The API key's ID.
+     * @param body - The data to update in the API key.
+     * @param query - Configure the fields to retrieve in the API key.
+     * @param headers - Headers to pass in the request.
+     * @returns The API key's details.
+     *
+     * @example
+     * sdk.admin.apiKey.update("apk_123", {
+     *   title: "Development"
+     * })
+     * .then(({ api_key }) => {
+     *   console.log(api_key)
+     * })
+     */
+    update(id: string, body: HttpTypes.AdminUpdateApiKey, query?: HttpTypes.AdminGetApiKeysParams, headers?: ClientHeaders): Promise<HttpTypes.AdminApiKeyResponse>;
+    /**
+     * This method deletes an API key by its ID. It sends a request to the
+     * [Delete API Key](https://docs.acmekit.com/api/admin#api-keys_deleteapikeysid) API route.
+     *
+     * @param id - The API key's ID.
+     * @param headers - Headers to pass in the request.
+     * @returns The deletion's details.
+     *
+     * @example
+     * sdk.admin.apiKey.delete("apk_123")
+     * .then(({ deleted }) => {
+     *   console.log(deleted)
+     * })
+     */
+    delete(id: string, headers?: ClientHeaders): Promise<HttpTypes.AdminApiKeyDeleteResponse>;
+    /**
+     * This method manages the sales channels associated with a publishable API key to either add
+     * or remove associations. It sends a request to the [Manage Sales Channels](https://docs.acmekit.com/api/admin#api-keys_postapikeysidsaleschannels)
+     * API route.
+     *
+     * @param id - The API key's ID.
+     * @param body - The sales channels to add or remove from the API key.
+     * @param headers - Headers to pass in the request.
+     * @returns The API key's details.
+     *
+     * @example
+     * sdk.admin.apiKey.batchSalesChannels("apk_123", {
+     *   add: ["sc_123"],
+     *   remove: ["sc_321"]
+     * })
+     * .then(({ api_key }) => {
+     *   console.log(api_key)
+     * })
+     */
+    batchSalesChannels(id: string, body: HttpTypes.AdminBatchLink, headers?: ClientHeaders): Promise<HttpTypes.AdminApiKeyResponse>;
+}
+//# sourceMappingURL=api-key.d.ts.map

package/dist/esm/admin/api-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.d.ts","sourceRoot":"","sources":["../../../src/admin/api-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,qBAAa,MAAM;IACjB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAQ;IACtB;;OAEG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACG,IAAI,CACR,WAAW,CAAC,EAAE,SAAS,CAAC,qBAAqB,EAC7C,OAAO,CAAC,EAAE,aAAa;IAUzB;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CACV,IAAI,EAAE,SAAS,CAAC,iBAAiB,EACjC,KAAK,CAAC,EAAE,SAAS,CAAC,qBAAqB,EACvC,OAAO,CAAC,EAAE,aAAa;IAazB;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IAUhD;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IASlD;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,SAAS,CAAC,iBAAiB,EACjC,KAAK,CAAC,EAAE,SAAS,CAAC,qBAAqB,EACvC,OAAO,CAAC,EAAE,aAAa;IAazB;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IAUhD;;;;;;;;;;;;;;;;;;OAkBG;IACG,kBAAkB,CACtB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,SAAS,CAAC,cAAc,EAC9B,OAAO,CAAC,EAAE,aAAa;CAW1B"}