prostgles-server 4.2.182 → 4.2.183

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-es/memoize.js

@@ -0,0 +1,45 @@
+export const memoize = (provider, isExpired, requiresRefresh) => {
+    let resolved;
+    let pending;
+    let hasResult;
+    let isConstant = false;
+    const coalesceProvider = async () => {
+        if (!pending) {
+            pending = provider();
+        }
+        try {
+            resolved = await pending;
+            hasResult = true;
+            isConstant = false;
+        }
+        finally {
+            pending = undefined;
+        }
+        return resolved;
+    };
+    if (isExpired === undefined) {
+        return async (options) => {
+            if (!hasResult || options?.forceRefresh) {
+                resolved = await coalesceProvider();
+            }
+            return resolved;
+        };
+    }
+    return async (options) => {
+        if (!hasResult || options?.forceRefresh) {
+            resolved = await coalesceProvider();
+        }
+        if (isConstant) {
+            return resolved;
+        }
+        if (requiresRefresh && !requiresRefresh(resolved)) {
+            isConstant = true;
+            return resolved;
+        }
+        if (isExpired(resolved)) {
+            await coalesceProvider();
+            return resolved;
+        }
+        return resolved;
+    };
+};

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/CredentialsProviderError.d.ts

@@ -0,0 +1,30 @@
+import { ProviderError, ProviderErrorOptionsType } from "./ProviderError";
+/**
+ * @public
+ *
+ * An error representing a failure of an individual credential provider.
+ *
+ * This error class has special meaning to the {@link chain} method. If a
+ * provider in the chain is rejected with an error, the chain will only proceed
+ * to the next provider if the value of the `tryNextLink` property on the error
+ * is truthy. This allows individual providers to halt the chain and also
+ * ensures the chain will stop if an entirely unexpected error is encountered.
+ */
+export declare class CredentialsProviderError extends ProviderError {
+    name: string;
+    /**
+     * @override
+     * @deprecated constructor should be given a logger.
+     */
+    constructor(message: string);
+    /**
+     * @override
+     * @deprecated constructor should be given a logger.
+     */
+    constructor(message: string, tryNextLink: boolean | undefined);
+    /**
+     * @override
+     * This signature is preferred for logging capability.
+     */
+    constructor(message: string, options: ProviderErrorOptionsType);
+}

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/ProviderError.d.ts

@@ -0,0 +1,39 @@
+import { Logger } from "@smithy/types";
+/**
+ * @public
+ */
+export type ProviderErrorOptionsType = {
+    tryNextLink?: boolean | undefined;
+    logger?: Logger;
+};
+/**
+ * @public
+ *
+ * An error representing a failure of an individual provider.
+ *
+ * This error class has special meaning to the {@link chain} method. If a
+ * provider in the chain is rejected with an error, the chain will only proceed
+ * to the next provider if the value of the `tryNextLink` property on the error
+ * is truthy. This allows individual providers to halt the chain and also
+ * ensures the chain will stop if an entirely unexpected error is encountered.
+ */
+export declare class ProviderError extends Error {
+    name: string;
+    readonly tryNextLink: boolean;
+    /**
+     * @deprecated constructor should be given a logger.
+     */
+    constructor(message: string);
+    /**
+     * @deprecated constructor should be given a logger.
+     */
+    constructor(message: string, tryNextLink: boolean | undefined);
+    /**
+     * This signature is preferred for logging capability.
+     */
+    constructor(message: string, options: ProviderErrorOptionsType);
+    /**
+     * @deprecated use new operator.
+     */
+    static from(error: Error, options?: boolean | ProviderErrorOptionsType): ProviderError;
+}

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/TokenProviderError.d.ts

@@ -0,0 +1,30 @@
+import { ProviderError, ProviderErrorOptionsType } from "./ProviderError";
+/**
+ * @public
+ *
+ * An error representing a failure of an individual token provider.
+ *
+ * This error class has special meaning to the {@link chain} method. If a
+ * provider in the chain is rejected with an error, the chain will only proceed
+ * to the next provider if the value of the `tryNextLink` property on the error
+ * is truthy. This allows individual providers to halt the chain and also
+ * ensures the chain will stop if an entirely unexpected error is encountered.
+ */
+export declare class TokenProviderError extends ProviderError {
+    name: string;
+    /**
+     * @override
+     * @deprecated constructor should be given a logger.
+     */
+    constructor(message: string);
+    /**
+     * @override
+     * @deprecated constructor should be given a logger.
+     */
+    constructor(message: string, tryNextLink: boolean | undefined);
+    /**
+     * @override
+     * This signature is preferred for logging capability.
+     */
+    constructor(message: string, options: ProviderErrorOptionsType);
+}

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/chain.d.ts

@@ -0,0 +1,13 @@
+import { Provider } from "@smithy/types";
+/**
+ * @internal
+ *
+ * Compose a single credential provider function from multiple credential
+ * providers. The first provider in the argument list will always be invoked;
+ * subsequent providers in the list will be invoked in the order in which the
+ * were received if the preceding provider did not successfully resolve.
+ *
+ * If no providers were received or no provider resolves successfully, the
+ * returned promise will be rejected.
+ */
+export declare const chain: <T>(...providers: Provider<T>[]) => Provider<T>;

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/fromStatic.d.ts

@@ -0,0 +1,5 @@
+import { Provider } from "@smithy/types";
+/**
+ * @internal
+ */
+export declare const fromStatic: <T>(staticValue: T) => Provider<T>;

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @internal
+ */
+export * from "./CredentialsProviderError";
+/**
+ * @internal
+ */
+export * from "./ProviderError";
+/**
+ * @internal
+ */
+export * from "./TokenProviderError";
+/**
+ * @internal
+ */
+export * from "./chain";
+/**
+ * @internal
+ */
+export * from "./fromStatic";
+/**
+ * @internal
+ */
+export * from "./memoize";

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/memoize.d.ts

@@ -0,0 +1,40 @@
+import { MemoizedProvider, Provider } from "@smithy/types";
+interface MemoizeOverload {
+    /**
+     *
+     * Decorates a provider function with either static memoization.
+     *
+     * To create a statically memoized provider, supply a provider as the only
+     * argument to this function. The provider will be invoked once, and all
+     * invocations of the provider returned by `memoize` will return the same
+     * promise object.
+     *
+     * @param provider The provider whose result should be cached indefinitely.
+     */
+    <T>(provider: Provider<T>): MemoizedProvider<T>;
+    /**
+     * Decorates a provider function with refreshing memoization.
+     *
+     * @param provider          The provider whose result should be cached.
+     * @param isExpired         A function that will evaluate the resolved value and
+     *                          determine if it is expired. For example, when
+     *                          memoizing AWS credential providers, this function
+     *                          should return `true` when the credential's
+     *                          expiration is in the past (or very near future) and
+     *                          `false` otherwise.
+     * @param requiresRefresh   A function that will evaluate the resolved value and
+     *                          determine if it represents static value or one that
+     *                          will eventually need to be refreshed. For example,
+     *                          AWS credentials that have no defined expiration will
+     *                          never need to be refreshed, so this function would
+     *                          return `true` if the credentials resolved by the
+     *                          underlying provider had an expiration and `false`
+     *                          otherwise.
+     */
+    <T>(provider: Provider<T>, isExpired: (resolved: T) => boolean, requiresRefresh?: (resolved: T) => boolean): MemoizedProvider<T>;
+}
+/**
+ * @internal
+ */
+export declare const memoize: MemoizeOverload;
+export {};

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/ts3.4/CredentialsProviderError.d.ts

@@ -0,0 +1,30 @@
+import { ProviderError, ProviderErrorOptionsType } from "./ProviderError";
+/**
+ * @public
+ *
+ * An error representing a failure of an individual credential provider.
+ *
+ * This error class has special meaning to the {@link chain} method. If a
+ * provider in the chain is rejected with an error, the chain will only proceed
+ * to the next provider if the value of the `tryNextLink` property on the error
+ * is truthy. This allows individual providers to halt the chain and also
+ * ensures the chain will stop if an entirely unexpected error is encountered.
+ */
+export declare class CredentialsProviderError extends ProviderError {
+    name: string;
+    /**
+     * @override
+     * @deprecated constructor should be given a logger.
+     */
+    constructor(message: string);
+    /**
+     * @override
+     * @deprecated constructor should be given a logger.
+     */
+    constructor(message: string, tryNextLink: boolean | undefined);
+    /**
+     * @override
+     * This signature is preferred for logging capability.
+     */
+    constructor(message: string, options: ProviderErrorOptionsType);
+}

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/ts3.4/ProviderError.d.ts

@@ -0,0 +1,39 @@
+import { Logger } from "@smithy/types";
+/**
+ * @public
+ */
+export type ProviderErrorOptionsType = {
+    tryNextLink?: boolean | undefined;
+    logger?: Logger;
+};
+/**
+ * @public
+ *
+ * An error representing a failure of an individual provider.
+ *
+ * This error class has special meaning to the {@link chain} method. If a
+ * provider in the chain is rejected with an error, the chain will only proceed
+ * to the next provider if the value of the `tryNextLink` property on the error
+ * is truthy. This allows individual providers to halt the chain and also
+ * ensures the chain will stop if an entirely unexpected error is encountered.
+ */
+export declare class ProviderError extends Error {
+    name: string;
+    readonly tryNextLink: boolean;
+    /**
+     * @deprecated constructor should be given a logger.
+     */
+    constructor(message: string);
+    /**
+     * @deprecated constructor should be given a logger.
+     */
+    constructor(message: string, tryNextLink: boolean | undefined);
+    /**
+     * This signature is preferred for logging capability.
+     */
+    constructor(message: string, options: ProviderErrorOptionsType);
+    /**
+     * @deprecated use new operator.
+     */
+    static from(error: Error, options?: boolean | ProviderErrorOptionsType): ProviderError;
+}

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/ts3.4/TokenProviderError.d.ts

@@ -0,0 +1,30 @@
+import { ProviderError, ProviderErrorOptionsType } from "./ProviderError";
+/**
+ * @public
+ *
+ * An error representing a failure of an individual token provider.
+ *
+ * This error class has special meaning to the {@link chain} method. If a
+ * provider in the chain is rejected with an error, the chain will only proceed
+ * to the next provider if the value of the `tryNextLink` property on the error
+ * is truthy. This allows individual providers to halt the chain and also
+ * ensures the chain will stop if an entirely unexpected error is encountered.
+ */
+export declare class TokenProviderError extends ProviderError {
+    name: string;
+    /**
+     * @override
+     * @deprecated constructor should be given a logger.
+     */
+    constructor(message: string);
+    /**
+     * @override
+     * @deprecated constructor should be given a logger.
+     */
+    constructor(message: string, tryNextLink: boolean | undefined);
+    /**
+     * @override
+     * This signature is preferred for logging capability.
+     */
+    constructor(message: string, options: ProviderErrorOptionsType);
+}

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/ts3.4/chain.d.ts

@@ -0,0 +1,13 @@
+import { Provider } from "@smithy/types";
+/**
+ * @internal
+ *
+ * Compose a single credential provider function from multiple credential
+ * providers. The first provider in the argument list will always be invoked;
+ * subsequent providers in the list will be invoked in the order in which the
+ * were received if the preceding provider did not successfully resolve.
+ *
+ * If no providers were received or no provider resolves successfully, the
+ * returned promise will be rejected.
+ */
+export declare const chain: <T>(...providers: Provider<T>[]) => Provider<T>;

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/ts3.4/fromStatic.d.ts

@@ -0,0 +1,5 @@
+import { Provider } from "@smithy/types";
+/**
+ * @internal
+ */
+export declare const fromStatic: <T>(staticValue: T) => Provider<T>;

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/ts3.4/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @internal
+ */
+export * from "./CredentialsProviderError";
+/**
+ * @internal
+ */
+export * from "./ProviderError";
+/**
+ * @internal
+ */
+export * from "./TokenProviderError";
+/**
+ * @internal
+ */
+export * from "./chain";
+/**
+ * @internal
+ */
+export * from "./fromStatic";
+/**
+ * @internal
+ */
+export * from "./memoize";

package/examples/full-example-typescript/node_modules/@smithy/property-provider/dist-types/ts3.4/memoize.d.ts

@@ -0,0 +1,40 @@
+import { MemoizedProvider, Provider } from "@smithy/types";
+interface MemoizeOverload {
+    /**
+     *
+     * Decorates a provider function with either static memoization.
+     *
+     * To create a statically memoized provider, supply a provider as the only
+     * argument to this function. The provider will be invoked once, and all
+     * invocations of the provider returned by `memoize` will return the same
+     * promise object.
+     *
+     * @param provider The provider whose result should be cached indefinitely.
+     */
+    <T>(provider: Provider<T>): MemoizedProvider<T>;
+    /**
+     * Decorates a provider function with refreshing memoization.
+     *
+     * @param provider          The provider whose result should be cached.
+     * @param isExpired         A function that will evaluate the resolved value and
+     *                          determine if it is expired. For example, when
+     *                          memoizing AWS credential providers, this function
+     *                          should return `true` when the credential's
+     *                          expiration is in the past (or very near future) and
+     *                          `false` otherwise.
+     * @param requiresRefresh   A function that will evaluate the resolved value and
+     *                          determine if it represents static value or one that
+     *                          will eventually need to be refreshed. For example,
+     *                          AWS credentials that have no defined expiration will
+     *                          never need to be refreshed, so this function would
+     *                          return `true` if the credentials resolved by the
+     *                          underlying provider had an expiration and `false`
+     *                          otherwise.
+     */
+    <T>(provider: Provider<T>, isExpired: (resolved: T) => boolean, requiresRefresh?: (resolved: T) => boolean): MemoizedProvider<T>;
+}
+/**
+ * @internal
+ */
+export declare const memoize: MemoizeOverload;
+export {};

package/examples/full-example-typescript/node_modules/@smithy/property-provider/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@smithy/property-provider",
+  "version": "3.1.11",
+  "scripts": {
+    "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types && yarn build:types:downlevel'",
+    "build:cjs": "node ../../scripts/inline property-provider",
+    "build:es": "yarn g:tsc -p tsconfig.es.json",
+    "build:types": "yarn g:tsc -p tsconfig.types.json",
+    "build:types:downlevel": "rimraf dist-types/ts3.4 && downlevel-dts dist-types dist-types/ts3.4",
+    "stage-release": "rimraf ./.release && yarn pack && mkdir ./.release && tar zxvf ./package.tgz --directory ./.release && rm ./package.tgz",
+    "clean": "rimraf ./dist-* && rimraf *.tsbuildinfo || exit 0",
+    "lint": "eslint -c ../../.eslintrc.js \"src/**/*.ts\"",
+    "format": "prettier --config ../../prettier.config.js --ignore-path ../.prettierignore --write \"**/*.{ts,md,json}\"",
+    "test": "yarn g:vitest run",
+    "test:watch": "yarn g:vitest watch"
+  },
+  "main": "./dist-cjs/index.js",
+  "module": "./dist-es/index.js",
+  "types": "./dist-types/index.d.ts",
+  "author": {
+    "name": "AWS SDK for JavaScript Team",
+    "url": "https://aws.amazon.com/javascript/"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@smithy/types": "^3.7.2",
+    "tslib": "^2.6.2"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "typesVersions": {
+    "<4.0": {
+      "dist-types/*": [
+        "dist-types/ts3.4/*"
+      ]
+    }
+  },
+  "files": [
+    "dist-*/**"
+  ],
+  "homepage": "https://github.com/awslabs/smithy-typescript/tree/main/packages/property-provider",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/awslabs/smithy-typescript.git",
+    "directory": "packages/property-provider"
+  },
+  "devDependencies": {
+    "concurrently": "7.0.0",
+    "downlevel-dts": "0.10.1",
+    "rimraf": "3.0.2",
+    "typedoc": "0.23.23"
+  },
+  "typedoc": {
+    "entryPoint": "src/index.ts"
+  },
+  "publishConfig": {
+    "directory": ".release/package"
+  }
+}