@aws-amplify/core 6.0.1-unstable.cfbde4c.0 → 6.0.1

package/lib-esm/Logger/ConsoleLogger.js

@@ -1,168 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { AWS_CLOUDWATCH_CATEGORY } from '../constants';
-const LOG_LEVELS = {
-    VERBOSE: 1,
-    DEBUG: 2,
-    INFO: 3,
-    WARN: 4,
-    ERROR: 5,
-};
-export var LOG_TYPE;
-(function (LOG_TYPE) {
-    LOG_TYPE["DEBUG"] = "DEBUG";
-    LOG_TYPE["ERROR"] = "ERROR";
-    LOG_TYPE["INFO"] = "INFO";
-    LOG_TYPE["WARN"] = "WARN";
-    LOG_TYPE["VERBOSE"] = "VERBOSE";
-})(LOG_TYPE || (LOG_TYPE = {}));
-/**
- * Write logs
- * @class Logger
- */
-class ConsoleLogger {
-    /**
-     * @constructor
-     * @param {string} name - Name of the logger
-     */
-    constructor(name, level = LOG_TYPE.WARN) {
-        this.name = name;
-        this.level = level;
-        this._pluggables = [];
-    }
-    _padding(n) {
-        return n < 10 ? '0' + n : '' + n;
-    }
-    _ts() {
-        const dt = new Date();
-        return ([this._padding(dt.getMinutes()), this._padding(dt.getSeconds())].join(':') +
-            '.' +
-            dt.getMilliseconds());
-    }
-    configure(config) {
-        if (!config)
-            return this._config;
-        this._config = config;
-        return this._config;
-    }
-    /**
-     * Write log
-     * @method
-     * @memeberof Logger
-     * @param {LOG_TYPE|string} type - log type, default INFO
-     * @param {string|object} msg - Logging message or object
-     */
-    _log(type, ...msg) {
-        let logger_level_name = this.level;
-        if (ConsoleLogger.LOG_LEVEL) {
-            logger_level_name = ConsoleLogger.LOG_LEVEL;
-        }
-        if (typeof window !== 'undefined' && window.LOG_LEVEL) {
-            logger_level_name = window.LOG_LEVEL;
-        }
-        const logger_level = LOG_LEVELS[logger_level_name];
-        const type_level = LOG_LEVELS[type];
-        if (!(type_level >= logger_level)) {
-            // Do nothing if type is not greater than or equal to logger level (handle undefined)
-            return;
-        }
-        let log = console.log.bind(console);
-        if (type === LOG_TYPE.ERROR && console.error) {
-            log = console.error.bind(console);
-        }
-        if (type === LOG_TYPE.WARN && console.warn) {
-            log = console.warn.bind(console);
-        }
-        const prefix = `[${type}] ${this._ts()} ${this.name}`;
-        let message = '';
-        if (msg.length === 1 && typeof msg[0] === 'string') {
-            message = `${prefix} - ${msg[0]}`;
-            log(message);
-        }
-        else if (msg.length === 1) {
-            message = `${prefix} ${msg[0]}`;
-            log(prefix, msg[0]);
-        }
-        else if (typeof msg[0] === 'string') {
-            let obj = msg.slice(1);
-            if (obj.length === 1) {
-                obj = obj[0];
-            }
-            message = `${prefix} - ${msg[0]} ${obj}`;
-            log(`${prefix} - ${msg[0]}`, obj);
-        }
-        else {
-            message = `${prefix} ${msg}`;
-            log(prefix, msg);
-        }
-        for (const plugin of this._pluggables) {
-            const logEvent = { message, timestamp: Date.now() };
-            plugin.pushLogs([logEvent]);
-        }
-    }
-    /**
-     * Write General log. Default to INFO
-     * @method
-     * @memeberof Logger
-     * @param {string|object} msg - Logging message or object
-     */
-    log(...msg) {
-        this._log(LOG_TYPE.INFO, ...msg);
-    }
-    /**
-     * Write INFO log
-     * @method
-     * @memeberof Logger
-     * @param {string|object} msg - Logging message or object
-     */
-    info(...msg) {
-        this._log(LOG_TYPE.INFO, ...msg);
-    }
-    /**
-     * Write WARN log
-     * @method
-     * @memeberof Logger
-     * @param {string|object} msg - Logging message or object
-     */
-    warn(...msg) {
-        this._log(LOG_TYPE.WARN, ...msg);
-    }
-    /**
-     * Write ERROR log
-     * @method
-     * @memeberof Logger
-     * @param {string|object} msg - Logging message or object
-     */
-    error(...msg) {
-        this._log(LOG_TYPE.ERROR, ...msg);
-    }
-    /**
-     * Write DEBUG log
-     * @method
-     * @memeberof Logger
-     * @param {string|object} msg - Logging message or object
-     */
-    debug(...msg) {
-        this._log(LOG_TYPE.DEBUG, ...msg);
-    }
-    /**
-     * Write VERBOSE log
-     * @method
-     * @memeberof Logger
-     * @param {string|object} msg - Logging message or object
-     */
-    verbose(...msg) {
-        this._log(LOG_TYPE.VERBOSE, ...msg);
-    }
-    addPluggable(pluggable) {
-        if (pluggable && pluggable.getCategoryName() === AWS_CLOUDWATCH_CATEGORY) {
-            this._pluggables.push(pluggable);
-            pluggable.configure(this._config);
-        }
-    }
-    listPluggables() {
-        return this._pluggables;
-    }
-}
-ConsoleLogger.LOG_LEVEL = null;
-export { ConsoleLogger };

package/lib-esm/Logger/index.d.ts

@@ -1 +0,0 @@
-export { ConsoleLogger, LOG_TYPE } from './ConsoleLogger';

package/lib-esm/Logger/index.js

@@ -1,3 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-export { ConsoleLogger, LOG_TYPE } from './ConsoleLogger';

package/lib-esm/Logger/logger-interface.d.ts

@@ -1,8 +0,0 @@
-import { LoggingProvider } from '../types';
-export interface Logger {
-    debug(msg: string): void;
-    info(msg: string): void;
-    warn(msg: string): void;
-    error(msg: string): void;
-    addPluggable(pluggable: LoggingProvider): void;
-}

package/lib-esm/Logger/logger-interface.js

@@ -1,3 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-export {};

package/lib-esm/Mutex/Mutex.js

@@ -1,66 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-/*!
- * The MIT License (MIT)
- *
- * Copyright (c) 2016 Christian Speckner <cnspeckn@googlemail.com>
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-export class Mutex {
-    constructor() {
-        this._queue = [];
-        this._pending = false;
-    }
-    isLocked() {
-        return this._pending;
-    }
-    acquire() {
-        const ticket = new Promise(resolve => this._queue.push(resolve));
-        if (!this._pending) {
-            this._dispatchNext();
-        }
-        return ticket;
-    }
-    runExclusive(callback) {
-        return this.acquire().then(release => {
-            let result;
-            try {
-                result = callback();
-            }
-            catch (e) {
-                release();
-                throw e;
-            }
-            return Promise.resolve(result).then((x) => (release(), x), e => {
-                release();
-                throw e;
-            });
-        });
-    }
-    _dispatchNext() {
-        if (this._queue.length > 0) {
-            this._pending = true;
-            this._queue.shift()(this._dispatchNext.bind(this));
-        }
-        else {
-            this._pending = false;
-        }
-    }
-}

package/lib-esm/Mutex/index.js

@@ -1,3 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-export { Mutex } from './Mutex';

package/lib-esm/Mutex/types.js

@@ -1,3 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-export {};

package/lib-esm/Platform/customUserAgent.js

@@ -1,52 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-// Maintains custom user-agent state set by external consumers.
-const customUserAgentState = {};
-/**
- * Sets custom user agent state which will be appended to applicable requests. Returns a function that can be used to
- * clean up any custom state set with this API.
- *
- * @note
- * This API operates globally. Calling this API multiple times will result in the most recently set values for a
- * particular API being used.
- *
- * @note
- * This utility IS NOT compatible with SSR.
- *
- * @param input - SetCustomUserAgentInput that defines custom state to apply to the specified APIs.
- */
-export const setCustomUserAgent = (input) => {
-    // Save custom user-agent state & increment reference counter
-    // TODO Remove `any` when we upgrade to TypeScript 5.2, see: https://github.com/microsoft/TypeScript/issues/44373
-    customUserAgentState[input.category] = input.apis.reduce((acc, api) => ({
-        ...acc,
-        [api]: {
-            refCount: acc[api]?.refCount ? acc[api].refCount + 1 : 1,
-            additionalDetails: input.additionalDetails,
-        },
-    }), customUserAgentState[input.category] ?? {});
-    // Callback that cleans up state for APIs recorded by this call
-    let cleanUpCallbackCalled = false;
-    const cleanUpCallback = () => {
-        // Only allow the cleanup callback to be called once
-        if (cleanUpCallbackCalled) {
-            return;
-        }
-        cleanUpCallbackCalled = true;
-        input.apis.forEach(api => {
-            const apiRefCount = customUserAgentState[input.category][api].refCount;
-            if (apiRefCount > 1) {
-                customUserAgentState[input.category][api].refCount = apiRefCount - 1;
-            }
-            else {
-                delete customUserAgentState[input.category][api];
-                // Clean up category if no more APIs set
-                if (!Object.keys(customUserAgentState[input.category]).length) {
-                    delete customUserAgentState[input.category];
-                }
-            }
-        });
-    };
-    return cleanUpCallback;
-};
-export const getCustomUserAgent = (category, api) => customUserAgentState[category]?.[api]?.additionalDetails;

package/lib-esm/Platform/detectFramework.js

@@ -1,64 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { Framework } from './types';
-import { detect } from './detection';
-// We want to cache detection since the framework won't change
-let frameworkCache;
-export const frameworkChangeObservers = [];
-// Setup the detection reset tracking / timeout delays
-let resetTriggered = false;
-const SSR_RESET_TIMEOUT = 10; // ms
-const WEB_RESET_TIMEOUT = 10; // ms
-const PRIME_FRAMEWORK_DELAY = 1000; // ms
-export const detectFramework = () => {
-    if (!frameworkCache) {
-        frameworkCache = detect();
-        if (resetTriggered) {
-            // The final run of detectFramework:
-            // Starting from this point, the `frameworkCache` becomes "final".
-            // So we don't need to notify the observers again so the observer
-            // can be removed after the final notice.
-            while (frameworkChangeObservers.length) {
-                frameworkChangeObservers.pop()?.();
-            }
-        }
-        else {
-            // The first run of detectFramework:
-            // Every time we update the cache, call each observer function
-            frameworkChangeObservers.forEach(fcn => fcn());
-        }
-        // Retry once for either Unknown type after a delay (explained below)
-        resetTimeout(Framework.ServerSideUnknown, SSR_RESET_TIMEOUT);
-        resetTimeout(Framework.WebUnknown, WEB_RESET_TIMEOUT);
-    }
-    return frameworkCache;
-};
-/**
- * @internal Setup observer callback that will be called everytime the framework changes
- */
-export const observeFrameworkChanges = (fcn) => {
-    // When the `frameworkCache` won't be updated again, we ignore all incoming
-    // observers.
-    if (resetTriggered) {
-        return;
-    }
-    frameworkChangeObservers.push(fcn);
-};
-export function clearCache() {
-    frameworkCache = undefined;
-}
-// For a framework type and a delay amount, setup the event to re-detect
-//   During the runtime boot, it is possible that framework detection will
-//   be triggered before the framework has made modifications to the
-//   global/window/etc needed for detection. When no framework is detected
-//   we will reset and try again to ensure we don't use a cached
-//   non-framework detection result for all requests.
-function resetTimeout(framework, delay) {
-    if (frameworkCache === framework && !resetTriggered) {
-        setTimeout(() => {
-            clearCache();
-            resetTriggered = true;
-            setTimeout(detectFramework, PRIME_FRAMEWORK_DELAY);
-        }, delay);
-    }
-}

package/lib-esm/Platform/detection/Angular.js

@@ -1,17 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { documentExists, processExists, windowExists } from './helpers';
-// Tested with @angular/core 16.0.0
-export function angularWebDetect() {
-    const angularVersionSetInDocument = Boolean(documentExists() && document.querySelector('[ng-version]'));
-    const angularContentSetInWindow = Boolean(
-    // @ts-ignore
-    windowExists() && typeof window['ng'] !== 'undefined');
-    return angularVersionSetInDocument || angularContentSetInWindow;
-}
-export function angularSSRDetect() {
-    return ((processExists() &&
-        typeof process.env === 'object' &&
-        process.env['npm_lifecycle_script']?.startsWith('ng ')) ||
-        false);
-}

package/lib-esm/Platform/detection/Expo.js

@@ -1,8 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { globalExists } from './helpers';
-// Tested with expo 48 / react-native 0.71.3
-export function expoDetect() {
-    // @ts-ignore
-    return globalExists() && typeof global['expo'] !== 'undefined';
-}

package/lib-esm/Platform/detection/Next.js

@@ -1,12 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { globalExists, keyPrefixMatch, windowExists } from './helpers';
-// Tested with next 13.4 / react 18.2
-export function nextWebDetect() {
-    // @ts-ignore
-    return windowExists() && window['next'] && typeof window['next'] === 'object';
-}
-export function nextSSRDetect() {
-    return (globalExists() &&
-        (keyPrefixMatch(global, '__next') || keyPrefixMatch(global, '__NEXT')));
-}

package/lib-esm/Platform/detection/Nuxt.js

@@ -1,13 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { globalExists, windowExists } from './helpers';
-// Tested with nuxt 2.15 / vue 2.7
-export function nuxtWebDetect() {
-    return (windowExists() &&
-        // @ts-ignore
-        (window['__NUXT__'] !== undefined || window['$nuxt'] !== undefined));
-}
-export function nuxtSSRDetect() {
-    // @ts-ignore
-    return globalExists() && typeof global['__NUXT_PATHS__'] !== 'undefined';
-}

package/lib-esm/Platform/detection/React.js

@@ -1,20 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { documentExists, processExists } from './helpers';
-// Tested with react 18.2 - built using Vite
-export function reactWebDetect() {
-    const elementKeyPrefixedWithReact = (key) => {
-        return key.startsWith('_react') || key.startsWith('__react');
-    };
-    const elementIsReactEnabled = (element) => {
-        return Object.keys(element).find(elementKeyPrefixedWithReact);
-    };
-    const allElementsWithId = () => Array.from(document.querySelectorAll('[id]'));
-    return documentExists() && allElementsWithId().some(elementIsReactEnabled);
-}
-export function reactSSRDetect() {
-    return (processExists() &&
-        typeof process.env !== 'undefined' &&
-        !!Object.keys(process.env).find(key => key.includes('react')));
-}
-// use the some

package/lib-esm/Platform/detection/ReactNative.js

@@ -1,8 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-// Tested with react-native 0.17.7
-export function reactNativeDetect() {
-    return (typeof navigator !== 'undefined' &&
-        typeof navigator.product !== 'undefined' &&
-        navigator.product === 'ReactNative');
-}

package/lib-esm/Platform/detection/Svelte.js

@@ -1,12 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { keyPrefixMatch, processExists, windowExists } from './helpers';
-// Tested with svelte 3.59
-export function svelteWebDetect() {
-    return windowExists() && keyPrefixMatch(window, '__SVELTE');
-}
-export function svelteSSRDetect() {
-    return (processExists() &&
-        typeof process.env !== 'undefined' &&
-        !!Object.keys(process.env).find(key => key.includes('svelte')));
-}

package/lib-esm/Platform/detection/Vue.js

@@ -1,10 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { globalExists, keyPrefixMatch, windowExists } from './helpers';
-// Tested with vue 3.3.2
-export function vueWebDetect() {
-    return windowExists() && keyPrefixMatch(window, '__VUE');
-}
-export function vueSSRDetect() {
-    return globalExists() && keyPrefixMatch(global, '__VUE');
-}

package/lib-esm/Platform/detection/Web.js

@@ -1,6 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { windowExists } from './helpers';
-export function webDetect() {
-    return windowExists();
-}

package/lib-esm/Platform/detection/helpers.js

@@ -1,20 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-export const globalExists = () => {
-    return typeof global !== 'undefined';
-};
-export const globalThisExists = () => {
-    return typeof globalThis !== 'undefined';
-};
-export const windowExists = () => {
-    return typeof window !== 'undefined';
-};
-export const documentExists = () => {
-    return typeof document !== 'undefined';
-};
-export const processExists = () => {
-    return typeof process !== 'undefined';
-};
-export const keyPrefixMatch = (object, prefix) => {
-    return !!Object.keys(object).find(key => key.startsWith(prefix));
-};

package/lib-esm/Platform/detection/index.js

@@ -1,37 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { Framework } from '../types';
-import { reactWebDetect, reactSSRDetect } from './React';
-import { vueWebDetect, vueSSRDetect } from './Vue';
-import { svelteWebDetect, svelteSSRDetect } from './Svelte';
-import { nextWebDetect, nextSSRDetect } from './Next';
-import { nuxtWebDetect, nuxtSSRDetect } from './Nuxt';
-import { angularWebDetect, angularSSRDetect } from './Angular';
-import { reactNativeDetect } from './ReactNative';
-import { expoDetect } from './Expo';
-import { webDetect } from './Web';
-// These are in the order of detection where when both are detectable, the early Framework will be reported
-const detectionMap = [
-    // First, detect mobile
-    { platform: Framework.Expo, detectionMethod: expoDetect },
-    { platform: Framework.ReactNative, detectionMethod: reactNativeDetect },
-    // Next, detect web frameworks
-    { platform: Framework.NextJs, detectionMethod: nextWebDetect },
-    { platform: Framework.Nuxt, detectionMethod: nuxtWebDetect },
-    { platform: Framework.Angular, detectionMethod: angularWebDetect },
-    { platform: Framework.React, detectionMethod: reactWebDetect },
-    { platform: Framework.VueJs, detectionMethod: vueWebDetect },
-    { platform: Framework.Svelte, detectionMethod: svelteWebDetect },
-    { platform: Framework.WebUnknown, detectionMethod: webDetect },
-    // Last, detect ssr frameworks
-    { platform: Framework.NextJsSSR, detectionMethod: nextSSRDetect },
-    { platform: Framework.NuxtSSR, detectionMethod: nuxtSSRDetect },
-    { platform: Framework.ReactSSR, detectionMethod: reactSSRDetect },
-    { platform: Framework.VueJsSSR, detectionMethod: vueSSRDetect },
-    { platform: Framework.AngularSSR, detectionMethod: angularSSRDetect },
-    { platform: Framework.SvelteSSR, detectionMethod: svelteSSRDetect },
-];
-export function detect() {
-    return (detectionMap.find(detectionEntry => detectionEntry.detectionMethod())
-        ?.platform || Framework.ServerSideUnknown);
-}

package/lib-esm/Platform/index.js

@@ -1,46 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { Framework } from './types';
-import { version } from './version';
-import { detectFramework, observeFrameworkChanges } from './detectFramework';
-import { getCustomUserAgent } from './customUserAgent';
-const BASE_USER_AGENT = `aws-amplify`;
-class PlatformBuilder {
-    constructor() {
-        this.userAgent = `${BASE_USER_AGENT}/${version}`;
-    }
-    get framework() {
-        return detectFramework();
-    }
-    get isReactNative() {
-        return (this.framework === Framework.ReactNative ||
-            this.framework === Framework.Expo);
-    }
-    observeFrameworkChanges(fcn) {
-        observeFrameworkChanges(fcn);
-    }
-}
-export const Platform = new PlatformBuilder();
-export const getAmplifyUserAgentObject = ({ category, action, framework, } = {}) => {
-    const userAgent = [[BASE_USER_AGENT, version]];
-    if (category) {
-        userAgent.push([category, action]);
-    }
-    userAgent.push(['framework', detectFramework()]);
-    if (category && action) {
-        const customState = getCustomUserAgent(category, action);
-        if (customState) {
-            customState.forEach(state => {
-                userAgent.push(state);
-            });
-        }
-    }
-    return userAgent;
-};
-export const getAmplifyUserAgent = (customUserAgentDetails) => {
-    const userAgent = getAmplifyUserAgentObject(customUserAgentDetails);
-    const userAgentString = userAgent
-        .map(([agentKey, agentValue]) => agentKey && agentValue ? `${agentKey}/${agentValue}` : agentKey)
-        .join(' ');
-    return userAgentString;
-};