@atlaskit/media-client 22.0.0 → 22.0.2

package/dist/types-ts4.5/utils/overrideMediaTypeIfUnknown.d.ts

@@ -0,0 +1,5 @@
+import { FileState } from '../models/file-state';
+import { MediaType } from '../models/media';
+export declare const overrideMediaTypeIfUnknown: (fileState: FileState, mediaType?: MediaType) => {
+    mediaType?: MediaType | undefined;
+};

package/dist/types-ts4.5/utils/parseJwt.d.ts

@@ -0,0 +1 @@
+export default function (token: string): unknown;

package/dist/types-ts4.5/utils/polling/errors.d.ts

@@ -0,0 +1,12 @@
+import { BaseMediaClientError } from '../../models/errors';
+import { PollingErrorReason, PollingErrorAttributes } from './types';
+export declare class PollingError extends BaseMediaClientError<PollingErrorAttributes> {
+    readonly reason: PollingErrorReason;
+    readonly attempts: number;
+    constructor(reason: PollingErrorReason, attempts: number);
+    get attributes(): {
+        reason: "pollingMaxAttemptsExceeded";
+        attempts: number;
+    };
+}
+export declare function isPollingError(err?: Error): err is PollingError;

package/dist/types-ts4.5/utils/polling/index.d.ts

@@ -0,0 +1,33 @@
+import { Executor } from './types';
+export interface PollingOptions {
+    poll_intervalMs: number;
+    poll_maxAttempts: number;
+    poll_backoffFactor: number;
+    poll_maxIntervalMs: number;
+}
+export declare const defaultPollingOptions: PollingOptions;
+/**
+ * This class encapsulates polling functionality with the following features:
+ *
+ *  - async executor function provides each attempt
+ *  - executor will only repeat defined max amount of times (options)
+ *  - each attempt uses a timeout to the next attempt by an interval (ms)
+ *  - each attempt increases the timeout interval by a "poll_backoffFactor"
+ *  - if max attempts are exceeded or executor has exception then onError handler is called
+ *
+ * IMPORTANT! the executor function must explicitly call ".next()" for the next iteration to run
+ */
+export declare class PollingFunction {
+    options: PollingOptions;
+    poll_intervalMs: number;
+    attempt: number;
+    shouldIterate: boolean;
+    onError?: (error: Error) => void;
+    timeoutId: number;
+    constructor(options?: Partial<PollingOptions>);
+    execute(executor: Executor): Promise<void>;
+    private fail;
+    getIntervalMsForIteration(iteration: number): number;
+    next(): void;
+    cancel(): void;
+}

package/dist/types-ts4.5/utils/polling/types.d.ts

@@ -0,0 +1,7 @@
+export type Executor = () => Promise<void>;
+export type PollingErrorReason = 'pollingMaxAttemptsExceeded';
+export type PollingErrorAttributes = {
+    readonly reason: PollingErrorReason;
+    readonly attempts: number;
+    readonly innerError?: Error;
+};

package/dist/types-ts4.5/utils/request/errors.d.ts

@@ -0,0 +1,20 @@
+import { BaseMediaClientError } from '../../models/errors';
+import { RequestErrorReason, RequestErrorMetadata, RequestErrorAttributes } from './types';
+export declare class RequestError extends BaseMediaClientError<RequestErrorAttributes> {
+    readonly reason: RequestErrorReason;
+    readonly metadata?: RequestErrorMetadata | undefined;
+    readonly innerError?: Error | undefined;
+    constructor(reason: RequestErrorReason, metadata?: RequestErrorMetadata | undefined, innerError?: Error | undefined);
+    get attributes(): {
+        reason: RequestErrorReason;
+        method: import("./types").RequestMethod | undefined;
+        endpoint: string | undefined;
+        mediaRegion: string | undefined;
+        mediaEnv: string | undefined;
+        attempts: number | undefined;
+        clientExhaustedRetries: boolean | undefined;
+        statusCode: number | undefined;
+        innerError: Error | undefined;
+    };
+}
+export declare function isRequestError(err: Error): err is RequestError;

package/dist/types-ts4.5/utils/request/helpers.d.ts

@@ -0,0 +1,46 @@
+import { Auth } from '@atlaskit/media-core';
+import { MediaTraceContext } from '@atlaskit/media-common';
+import { RequestError } from './errors';
+import { CreateUrlOptions, RequestErrorReason, RequestErrorMetadata, RequestHeaders, RequestMetadata, RetryOptions } from './types';
+export declare function clientTimeoutPromise(timeout: number): Promise<Response>;
+export declare function waitPromise(timeout: number): Promise<void>;
+export declare function isAbortedRequestError(err: any): boolean;
+export declare function isFetchNetworkError(err: any): err is TypeError;
+export declare function isRateLimitedError(error: Error | undefined): boolean;
+export declare const ZipkinHeaderKeys: {
+    traceId: string;
+    spanId: string;
+    parentSpanId: string;
+    sampled: string;
+    flags: string;
+};
+export declare function mapAuthToRequestHeaders(auth?: Auth): RequestHeaders;
+export declare function createUrl(url: string, { params, auth }: CreateUrlOptions): string;
+export declare function extendHeaders(headers?: RequestHeaders, auth?: Auth, traceContext?: Required<MediaTraceContext>): RequestHeaders | undefined;
+/**
+ * @deprecated Helper is deprecated and will be removed in the next major version.
+ * TODO: https://product-fabric.atlassian.net/browse/BMPT-1354
+ */
+export declare function mapResponseToJson(response: Response): Promise<any>;
+/**
+ * @deprecated Helper is deprecated and will be removed in the next major version.
+ * TODO: https://product-fabric.atlassian.net/browse/BMPT-1354
+ */
+export declare function mapResponseToBlob(response: Response): Promise<Blob>;
+/**
+ * @deprecated Helper is deprecated and will be removed in the next major version.
+ * TODO: https://product-fabric.atlassian.net/browse/BMPT-1354
+ */
+export declare function mapResponseToVoid(): Promise<void>;
+export declare function createMapResponseToJson(metadata: RequestMetadata): (response: Response) => Promise<any>;
+export declare function createMapResponseToBlob(metadata: RequestMetadata): (response: Response) => Promise<Blob>;
+export declare const DEFAULT_RETRY_OPTIONS: RetryOptions;
+export declare function cloneRequestError(error: RequestError, extraMetadata: Partial<RequestErrorMetadata>): RequestError;
+export declare function fetchRetry(functionToRetry: () => Promise<Response>, metadata: RequestMetadata, overwriteOptions?: Partial<RetryOptions>): Promise<Response>;
+export declare function createRequestErrorReason(statusCode: number): RequestErrorReason;
+export declare function createRequestErrorFromResponse(metadata: RequestErrorMetadata, response: Response): RequestError;
+export declare function createProcessFetchResponse(metadata: RequestMetadata): (response: Response) => Response;
+export declare function extractMediaHeaders(response: Response): {
+    mediaRegion: string;
+    mediaEnv: string;
+};

package/dist/types-ts4.5/utils/request/index.d.ts

@@ -0,0 +1,5 @@
+import { RequestOptions } from './types';
+export type { RequestErrorReason, RequestErrorMetadata, RequestErrorAttributes, } from './types';
+export { RequestError, isRequestError } from './errors';
+export { isRateLimitedError } from './helpers';
+export declare function request(url: string, options?: RequestOptions, controller?: AbortController): Promise<Response>;

package/dist/types-ts4.5/utils/request/types.d.ts

@@ -0,0 +1,46 @@
+import { Auth } from '@atlaskit/media-core';
+import type { MediaTraceContext } from '@atlaskit/media-common';
+export type RequestMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+export type RequestParams = {
+    [key: string]: any;
+};
+export type RequestHeaders = {
+    [key: string]: string;
+};
+export type RetryOptions = {
+    readonly startTimeoutInMs: number;
+    readonly maxAttempts: number;
+    readonly factor: number;
+};
+export type ClientOptions = {
+    readonly retryOptions?: Partial<RetryOptions>;
+    readonly clientTimeout?: number;
+};
+export type RequestMetadata = {
+    readonly method?: RequestMethod;
+    readonly endpoint?: string;
+    readonly mediaRegion?: string;
+    readonly mediaEnv?: string;
+    readonly traceContext?: MediaTraceContext;
+};
+export type RequestOptions = RequestMetadata & {
+    readonly auth?: Auth;
+    readonly traceContext?: Required<MediaTraceContext>;
+    readonly params?: RequestParams;
+    readonly headers?: RequestHeaders;
+    readonly body?: any;
+    readonly clientOptions?: ClientOptions;
+};
+export type CreateUrlOptions = {
+    readonly params?: RequestParams;
+    readonly auth?: Auth;
+};
+export type RequestErrorReason = 'clientOffline' | 'clientAbortedRequest' | 'clientTimeoutRequest' | 'serverInvalidBody' | 'serverBadRequest' | 'serverUnauthorized' | 'serverForbidden' | 'serverNotFound' | 'serverRateLimited' | 'serverInternalError' | 'serverBadGateway' | 'serverUnexpectedError';
+export type RequestErrorMetadata = RequestMetadata & {
+    readonly attempts?: number;
+    readonly clientExhaustedRetries?: boolean;
+    readonly statusCode?: number;
+};
+export type RequestErrorAttributes = RequestErrorMetadata & {
+    readonly reason: RequestErrorReason;
+};

package/dist/types-ts4.5/utils/safeUnsubscribe.d.ts

@@ -0,0 +1,2 @@
+import { MediaSubscription } from './mediaSubscribable';
+export declare const safeUnsubscribe: (subscription: MediaSubscription) => void;

package/dist/types-ts4.5/utils/setTimeoutPromise.d.ts

@@ -0,0 +1,2 @@
+export declare const resolveTimeout: <T>(timeout: number, resolveWith: T) => Promise<T>;
+export declare const rejectTimeout: (timeout: number, rejectWith: Error) => Promise<undefined>;

package/dist/types-ts4.5/utils/shouldFetchRemoteFileStates.d.ts

@@ -0,0 +1,16 @@
+import { Observable } from 'rxjs/Observable';
+import { FilePreview } from '../models/file-state';
+import { MediaType } from '../models/media';
+/**
+ * Async helper determining if we should fetch remote fileStates from the backend:
+ * - we poll the backend for all supported documents,
+ * - we poll the backend is mimeType isn't natively supported by the browser,
+ * - we poll the backend if we don't have a local preview available.
+ * - we poll the backend if we have a video with which we can't extract dimensions,
+ *
+ * Polling the backend periodically refreshes the cached fileState until the file is processed.
+ * Polling is needed for the use cases above to properly render the file in our components.
+ *
+ */
+export declare function shouldFetchRemoteFileStates(mediaType: MediaType, mimeType: string, preview?: FilePreview | Promise<FilePreview>): Promise<boolean>;
+export declare function shouldFetchRemoteFileStatesObservable(mediaType: MediaType, mimeType: string, preview?: FilePreview | Promise<FilePreview>): Observable<boolean>;

package/dist/types-ts4.5/utils/url.d.ts

@@ -0,0 +1,17 @@
+export declare const isMediaBlobUrl: (url: string) => boolean;
+export interface MediaBlobUrlAttrs {
+    id: string;
+    contextId: string;
+    collection?: string;
+    size?: number;
+    name?: string;
+    mimeType?: string;
+    width?: number;
+    height?: number;
+    alt?: string;
+}
+export declare const getAttrsFromUrl: (blobUrl: string) => MediaBlobUrlAttrs | undefined;
+export declare const objectToQueryString: (json: {
+    [key: string]: string | number | boolean | null | undefined;
+}) => string;
+export declare const addFileAttrsToUrl: (url: string, fileAttrs: MediaBlobUrlAttrs) => string;

package/dist/types-ts4.5/utils/with-media-client-hoc.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { MediaClientConfig } from '@atlaskit/media-core';
+import { MediaFeatureFlags } from '@atlaskit/media-common';
+import { MediaClient } from '../client/media-client';
+import { Identifier } from '../identifier';
+export interface WithMediaClientConfig {
+    mediaClientConfig: MediaClientConfig;
+}
+export interface WithMediaClient {
+    mediaClient: MediaClient;
+    identifier?: Identifier;
+}
+export declare const getMediaClient: (mediaClientConfig: MediaClientConfig, featureFlags?: MediaFeatureFlags) => MediaClient;
+export type WithMediaClientConfigProps<P extends WithMediaClient> = Omit<P, 'mediaClient'> & WithMediaClientConfig;
+export type WithMediaClientFunction = <P extends WithMediaClient>(Component: React.ComponentType<P>, featureFlags?: MediaFeatureFlags) => React.ComponentType<WithMediaClientConfigProps<P>>;
+export declare const withMediaClient: WithMediaClientFunction;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/media-client",
-  "version": "22.0.0",
+  "version": "22.0.2",
   "description": "Media API Web Client Library",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
@@ -12,6 +12,14 @@
   "module": "dist/esm/index.js",
   "module:es2019": "dist/es2019/index.js",
   "types": "dist/types/index.d.ts",
+  "typesVersions": {
+    ">=4.5 <4.9": {
+      "*": [
+        "dist/types-ts4.5/*",
+        "dist/types-ts4.5/index.d.ts"
+      ]
+    }
+  },
   "sideEffects": false,
   "atlaskit:src": "src/index.ts",
   "af:exports": {
@@ -42,18 +50,18 @@
     "xstate": "4.20.0"
   },
   "peerDependencies": {
-    "@atlaskit/media-core": "^34.1.0",
+    "@atlaskit/media-core": "^34.1.2",
     "@emotion/react": "^11.7.1",
     "react": "^16.8.0"
   },
   "devDependencies": {
     "@atlaskit/button": "^16.7.0",
     "@atlaskit/docs": "*",
-    "@atlaskit/media-card": "^74.8.0",
+    "@atlaskit/media-card": "^75.0.0",
     "@atlaskit/media-core": "^34.1.0",
     "@atlaskit/media-test-helpers": "^33.0.0",
     "@atlaskit/ssr": "*",
-    "@atlaskit/tokens": "^1.3.0",
+    "@atlaskit/tokens": "^1.4.0",
     "@atlassian/atlassian-frontend-prettier-config-1.0.1": "npm:@atlassian/atlassian-frontend-prettier-config@1.0.1",
     "@emotion/react": "^11.7.1",
     "@types/deep-equal": "^1.0.1",
@@ -62,7 +70,7 @@
     "fetch-mock": "^8.0.0",
     "react": "^16.8.0",
     "react-dom": "^16.8.0",
-    "typescript": "4.5.5"
+    "typescript": "~4.9.5"
   },
   "resolutions": {},
   "techstack": {

package/report.api.md

@@ -469,7 +469,7 @@ export interface GetFileOptions {
 // @public (undocumented)
 export const getMediaClient: (
   mediaClientConfig: MediaClientConfig,
-  featureFlags?: MediaFeatureFlags | undefined,
+  featureFlags?: MediaFeatureFlags,
 ) => MediaClient;
 
 // @public (undocumented)
@@ -528,7 +528,7 @@ export type ImageResizeMode = 'crop' | 'fit' | 'full-fit' | 'stretchy-fit';
 
 // @public (undocumented)
 export const imageResizeModeToFileImageMode: (
-  resizeMode?: ImageResizeMode | undefined,
+  resizeMode?: ImageResizeMode,
 ) => MediaStoreGetFileImageParams['mode'];
 
 // @public (undocumented)
@@ -620,7 +620,7 @@ export const isPreviewableFileState: (
 // @public (undocumented)
 export const isPreviewableType: (
   type: MediaType,
-  featureFlags?: MediaFeatureFlags | undefined,
+  featureFlags?: MediaFeatureFlags,
 ) => boolean;
 
 // @public (undocumented)
@@ -989,7 +989,7 @@ export class MediaStore {
     controller?: AbortController,
   ): Promise<Response>;
   // (undocumented)
-  resolveAuth: (authContext?: AuthContext | undefined) => Promise<Auth>;
+  resolveAuth: (authContext?: AuthContext) => Promise<Auth>;
   // (undocumented)
   resolveInitialAuth: () => Auth;
   // (undocumented)
@@ -1589,8 +1589,8 @@ export const uploadFile: (
   file: UploadableFile,
   store: MediaStore,
   uploadableFileUpfrontIds: UploadableFileUpfrontIds,
-  callbacks?: UploadFileCallbacks | undefined,
-  traceContext?: MediaTraceContext | undefined,
+  callbacks?: UploadFileCallbacks,
+  traceContext?: MediaTraceContext,
 ) => UploadFileResult;
 
 // @public (undocumented)
@@ -1670,7 +1670,7 @@ export type WithMediaClientFunction = <P extends WithMediaClient>(
 
 ```json
 {
-  "@atlaskit/media-core": "^34.0.2",
+  "@atlaskit/media-core": "^34.1.1",
   "@emotion/react": "^11.7.1",
   "react": "^16.8.0"
 }