@sparted/shared-library 1.1.2 → 1.1.3

package/src/cdn/__tests__/utils.test.ts

@@ -0,0 +1,528 @@
+import {
+  imgixTransformationQueries,
+  twicpicsTransformationQueries,
+} from '../cdn.factory';
+import { extractInfoFromUrl } from '../utils/extract-info-from-url.util';
+import { genCacheVersionQuery, getCdnUrlFactory } from '../utils/get-cdn-url.util';
+import { getCdnFromS3UrlFactory } from '../utils/get-cdn-from-s3-url.util';
+import type { InstanceMapper } from '../types';
+
+describe('extract-info-from-url', () => {
+  it('should handle non-aws s3 url', () => {
+    const info = extractInfoFromUrl('https://www.google.com');
+
+    expect(info).toBeUndefined();
+  });
+
+  it('should handle all aws s3 url', () => {
+    const { instanceId: instanceIdEW1, path: pathEW1 } = extractInfoFromUrl(
+      'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+    ) ?? {};
+
+    expect(instanceIdEW1).toBe('check');
+    expect(pathEW1).toBe('/path/to/something');
+
+    const { instanceId: instanceIdAmazonaws, path: pathAmazonaws } = extractInfoFromUrl(
+      'https://sparted-prod-check.s3.amazonaws.com/path/to/something',
+    ) ?? {};
+
+    expect(instanceIdAmazonaws).toBe('check');
+    expect(pathAmazonaws).toBe('/path/to/something');
+
+    const { instanceId: instanceIdCloud, path: pathCloud } = extractInfoFromUrl(
+      'https://sparted-prod-check.s3.fr-par.scw.cloud/path/to/something',
+    ) ?? {};
+
+    expect(instanceIdCloud).toBe('check');
+    expect(pathCloud).toBe('/path/to/something');
+  });
+
+  it('should handle any param and not crash', () => {
+    // @ts-ignore - Passing wrong param to fn in test
+    expect(extractInfoFromUrl()).toBeUndefined();
+    // @ts-ignore - Passing wrong param to fn in test
+    expect(extractInfoFromUrl([])).toBeUndefined();
+    // @ts-ignore - Passing wrong param to fn in test
+    expect(extractInfoFromUrl({})).toBeUndefined();
+    expect(extractInfoFromUrl('')).toBeUndefined();
+  });
+});
+
+describe('getCdnUrlFactory', () => {
+  it('Imgix - should generate url without params', () => {
+    const domain = 'https://sparted.imgix.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: imgixTransformationQueries,
+    });
+
+    expect(getCdnUrl('test', '/path/to/something')).toBe(
+      'https://sparted.imgix.fr/prod/test/path/to/something?auto=compress%2Cformat',
+    );
+  });
+
+  it('Twicpics - should generate url without params', () => {
+    const domain = 'https://sparted.twicpics.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: twicpicsTransformationQueries,
+    });
+
+    expect(getCdnUrl('test', '/path/to/something')).toBe(
+      'https://sparted.twicpics.fr/prod/test/path/to/something?twic=v1/quality=90',
+    );
+  });
+
+  it('Imgix - should generate url with cache param', () => {
+    const domain = 'https://sparted.imgix.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: imgixTransformationQueries,
+      cacheVersion: 3,
+    });
+
+    expect(getCdnUrl('test', '/path/to/something')).toBe(
+      'https://sparted.imgix.fr/prod/test/path/to/something?auto=compress%2Cformat&v=3',
+    );
+  });
+
+  it('Twicpics - should generate url with cache param', () => {
+    const domain = 'https://sparted.twicpics.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: twicpicsTransformationQueries,
+      cacheVersion: 3,
+    });
+
+    expect(getCdnUrl('test', '/path/to/something')).toBe(
+      'https://sparted.twicpics.fr/prod/test/path/to/something?twic=v1/quality=90&v=3',
+    );
+  });
+
+  it('Imgix - should generate url of image as thumbnail', () => {
+    const domain = 'https://sparted.imgix.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: imgixTransformationQueries,
+    });
+
+    expect(getCdnUrl('test', '/path/to/something', { asThumbnail: true })).toBe(
+      'https://sparted.imgix.fr/prod/test/path/to/something?auto=compress%2Cformat&h=300&w=300',
+    );
+  });
+
+  it('Twicpics - should generate url of image as thumbnail', () => {
+    const domain = 'https://sparted.twicpics.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: twicpicsTransformationQueries,
+    });
+
+    expect(getCdnUrl('test', '/path/to/something', { asThumbnail: true })).toBe(
+      'https://sparted.twicpics.fr/prod/test/path/to/something?twic=v1/quality=90/cover=300x300',
+    );
+  });
+
+  it('Imgix - should generate url with params', () => {
+    const domain = 'https://sparted.imgix.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: imgixTransformationQueries,
+    });
+
+    expect(
+      getCdnUrl('test', '/path/to/something', {
+        transformation: { fit: 'crop', height: 1, width: 1 },
+      }),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/test/path/to/something?auto=compress%2Cformat&fit=crop&h=1&w=1',
+    );
+
+    expect(
+      getCdnUrl('test', '/path/to/something', {
+        transformation: { fit: 'crop', width: 1 },
+      }),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/test/path/to/something?auto=compress%2Cformat&fit=crop&w=1',
+    );
+
+    expect(
+      getCdnUrl('test', '/path/to/something', {
+        transformation: { fit: 'crop', height: 1 },
+      }),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/test/path/to/something?auto=compress%2Cformat&fit=crop&h=1',
+    );
+
+    expect(
+      getCdnUrl('test', '/path/to/something', { transformation: { width: 1 } }),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/test/path/to/something?auto=compress%2Cformat&w=1',
+    );
+
+    expect(
+      getCdnUrl('test', '/path/to/something', { transformation: { height: 1 } }),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/test/path/to/something?auto=compress%2Cformat&h=1',
+    );
+
+    expect(
+      getCdnUrl('test', '/path/to/something', {
+        transformation: { height: 1, width: 1 },
+      }),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/test/path/to/something?auto=compress%2Cformat&h=1&w=1',
+    );
+
+    expect(
+      getCdnUrl('test', '/path/to/something', {
+        transformation: { devicePixelRatio: 2 },
+      }),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/test/path/to/something?auto=compress%2Cformat&dpr=2',
+    );
+
+    expect(
+      getCdnUrl('test', '/path/to/something', {
+        transformation: { quality: 75 },
+      }),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/test/path/to/something?auto=compress%2Cformat&q=75',
+    );
+  });
+
+  it('Twicpics - should generate url of image as thumbnail', () => {
+    const domain = 'https://sparted.twicpics.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: twicpicsTransformationQueries,
+    });
+
+    expect(
+      getCdnUrl('test', '/path/to/something', {
+        transformation: { fit: 'crop', height: 1, width: 1 },
+      }),
+    ).toBe(
+      'https://sparted.twicpics.fr/prod/test/path/to/something?twic=v1/quality=90/crop=1x1',
+    );
+
+    expect(
+      getCdnUrl('test', '/path/to/something', {
+        transformation: { fit: 'contain', height: 1, width: 1 },
+      }),
+    ).toBe(
+      'https://sparted.twicpics.fr/prod/test/path/to/something?twic=v1/quality=90/contain=1x1',
+    );
+
+    expect(
+      getCdnUrl('test', '/path/to/something', { transformation: { width: 1 } }),
+    ).toBe(
+      'https://sparted.twicpics.fr/prod/test/path/to/something?twic=v1/quality=90/cover=1x-',
+    );
+  });
+});
+
+describe('getCdnFromS3UrlFactory', () => {
+  it('Imgix - should handle non-aws s3 url', () => {
+    const domain = 'https://sparted.imgix.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: imgixTransformationQueries,
+    });
+
+    const getCdnFromS3Url = getCdnFromS3UrlFactory({
+      getCdnUrl,
+    });
+
+    expect(getCdnFromS3Url('https://www.google.com')).toBe(
+      'https://www.google.com',
+    );
+  });
+
+  it('Twicpics - should handle non-aws s3 url', () => {
+    const domain = 'https://sparted.twicpics.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: twicpicsTransformationQueries,
+    });
+
+    const getCdnFromS3Url = getCdnFromS3UrlFactory({
+      getCdnUrl,
+    });
+
+    expect(getCdnFromS3Url('https://www.google.com')).toBe(
+      'https://www.google.com',
+    );
+  });
+
+  it('Imgix - should handle all aws s3 url with no params', () => {
+    const domain = 'https://sparted.imgix.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: imgixTransformationQueries,
+    });
+
+    const getCdnFromS3Url = getCdnFromS3UrlFactory({
+      getCdnUrl,
+    });
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+      ),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/check/path/to/something?auto=compress%2Cformat',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.amazonaws.com/path/to/something',
+      ),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/check/path/to/something?auto=compress%2Cformat',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.fr-par.scw.cloud/path/to/something',
+      ),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/check/path/to/something?auto=compress%2Cformat',
+    );
+  });
+
+  it('Twicpics - should handle all aws s3 url with no params', () => {
+    const domain = 'https://sparted.twicpics.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: twicpicsTransformationQueries,
+    });
+
+    const getCdnFromS3Url = getCdnFromS3UrlFactory({
+      getCdnUrl,
+    });
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+      ),
+    ).toBe('https://sparted.twicpics.fr/prod/check/path/to/something?twic=v1/quality=90');
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.amazonaws.com/path/to/something',
+      ),
+    ).toBe('https://sparted.twicpics.fr/prod/check/path/to/something?twic=v1/quality=90');
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.fr-par.scw.cloud/path/to/something',
+      ),
+    ).toBe('https://sparted.twicpics.fr/prod/check/path/to/something?twic=v1/quality=90');
+  });
+
+  it('Imgix - should handle params', () => {
+    const domain = 'https://sparted.imgix.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: imgixTransformationQueries,
+    });
+
+    const getCdnFromS3Url = getCdnFromS3UrlFactory({
+      getCdnUrl,
+    });
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { fit: 'crop', height: 1, width: 1 },
+        },
+      ),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/check/path/to/something?auto=compress%2Cformat&fit=crop&h=1&w=1',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { fit: 'crop', width: 1 },
+        },
+      ),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/check/path/to/something?auto=compress%2Cformat&fit=crop&w=1',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { fit: 'crop', height: 1 },
+        },
+      ),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/check/path/to/something?auto=compress%2Cformat&fit=crop&h=1',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { width: 1 },
+        },
+      ),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/check/path/to/something?auto=compress%2Cformat&w=1',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { height: 1 },
+        },
+      ),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/check/path/to/something?auto=compress%2Cformat&h=1',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { height: 1, width: 1 },
+        },
+      ),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/check/path/to/something?auto=compress%2Cformat&h=1&w=1',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { devicePixelRatio: 2 },
+        },
+      ),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/check/path/to/something?auto=compress%2Cformat&dpr=2',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { quality: 75 },
+        },
+      ),
+    ).toBe(
+      'https://sparted.imgix.fr/prod/check/path/to/something?auto=compress%2Cformat&q=75',
+    );
+  });
+
+  it('Twicpics - should handle params', () => {
+    const domain = 'https://sparted.twicpics.fr';
+    const instanceMapper: InstanceMapper = (instanceId) => `/prod/${instanceId}`;
+    const getCdnUrl = getCdnUrlFactory({
+      domain,
+      instanceMapper,
+      transformationQueries: twicpicsTransformationQueries,
+    });
+
+    const getCdnFromS3Url = getCdnFromS3UrlFactory({
+      getCdnUrl,
+    });
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { fit: 'crop', height: 1, width: 1 },
+        },
+      ),
+    ).toBe(
+      'https://sparted.twicpics.fr/prod/check/path/to/something?twic=v1/quality=90/crop=1x1',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { fit: 'contain', height: 1, width: 1 },
+        },
+      ),
+    ).toBe(
+      'https://sparted.twicpics.fr/prod/check/path/to/something?twic=v1/quality=90/contain=1x1',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { width: 1 },
+        },
+      ),
+    ).toBe(
+      'https://sparted.twicpics.fr/prod/check/path/to/something?twic=v1/quality=90/cover=1x-',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { width: 1, output: 'webp' },
+        },
+      ),
+    ).toBe(
+      'https://sparted.twicpics.fr/prod/check/path/to/something?twic=v1/quality=90/cover=1x-/output=webp',
+    );
+
+    expect(
+      getCdnFromS3Url(
+        'https://sparted-prod-check.s3.eu-west-1/path/to/something',
+        {
+          transformation: { fit: 'contain', height: 300, width: 200, output: 'png' },
+        },
+      ),
+    ).toBe(
+      'https://sparted.twicpics.fr/prod/check/path/to/something?twic=v1/quality=90/contain=200x300/output=png',
+    );
+  });
+});
+
+describe('cacheVersionQuery', () => {
+  it('should return cache version query', () => {
+    expect(genCacheVersionQuery(2)).toBe('v=2');
+  });
+
+  it('should return empty string if cache version is not provided', () => {
+    expect(genCacheVersionQuery()).toBe('');
+  });
+});

package/src/cdn/cdn.factory.ts

@@ -0,0 +1,70 @@
+import { buildSearchParams } from '../http/build-search-params';
+import type { CdnConfig, CdnType, TransformationQueries, TwicpicsTransformationChain } from './types';
+import { getCdnFromS3UrlFactory } from './utils/get-cdn-from-s3-url.util';
+import { getCdnUrlFactory } from './utils/get-cdn-url.util';
+import { twicpicsTransformationChainToString } from './utils/twicpics-transformations.util';
+
+export const imgixTransformationQueries: TransformationQueries = ({
+  fit,
+  width,
+  height,
+  quality,
+  compress = true,
+  devicePixelRatio,
+}) => {
+  const params = {
+    auto: compress ? 'compress,format' : undefined,
+    fit: fit === 'crop' ? 'crop' : undefined,
+    dpr: Number.isFinite(devicePixelRatio) ? devicePixelRatio : undefined,
+    h: Number.isFinite(height) ? height : undefined,
+    w: Number.isFinite(width) ? width : undefined,
+    q: quality !== undefined && quality >= 0 && quality <= 100 ? quality : undefined,
+  };
+  const searchParams = buildSearchParams(params).toString();
+
+  return searchParams ? `${searchParams}` : '';
+};
+
+export const twicpicsTransformationQueries: TransformationQueries = (params) => {
+  const quality = params.quality || 90;
+  const transformations: TwicpicsTransformationChain = [['quality', quality]];
+  const dpr = params.devicePixelRatio || 1;
+
+  const width = params.width ? Math.round(params.width * dpr) : '-';
+  const height = params.height ? Math.round(params.height * dpr) : '-';
+  const fit = params.fit || 'cover';
+
+  if (params.width !== undefined || params.height !== undefined) {
+    transformations.push([fit, `${width}x${height}`]);
+  }
+
+  if (params.output !== undefined) {
+    transformations.push(['output', params.output]);
+  }
+
+  return twicpicsTransformationChainToString(transformations);
+};
+
+/**
+ *
+ * @param type cdn provider: 'twicpics' | 'imgix'
+ * @param domain provider domain
+ * @param instanceMapper domain + the result of the instanceMapper will form the base path
+ * @param cacheVersion
+ * @returns \{ getCdnUrl, transformationQueries \}
+ */
+export const createCdn = <T extends CdnType>({ type, domain, instanceMapper, cacheVersion }: CdnConfig<T>) => {
+  const getCdnUrl = getCdnUrlFactory({
+    domain,
+    instanceMapper,
+    transformationQueries: type === 'imgix' ? imgixTransformationQueries : twicpicsTransformationQueries,
+    cacheVersion,
+  });
+
+  return {
+    getCdnUrl,
+    getCdnFromS3Url: getCdnFromS3UrlFactory({
+      getCdnUrl,
+    }),
+  };
+};

package/src/cdn/index.ts

@@ -0,0 +1,2 @@
+export { createCdn } from './cdn.factory';
+export * from './types';

package/src/cdn/types/cdn-factory.type.ts

@@ -0,0 +1,49 @@
+export type BaseUrlMapperFunc = (instanceId: string) => string;
+
+export type Transformation = {
+  fit?: 'crop' | 'contain';
+  width?: number;
+  height?: number;
+  devicePixelRatio?: number;
+  quality?: number;
+  /**
+   * Only for imgix transformations. Default is true.
+   */
+  compress?: boolean;
+  output?: 'jpeg' | 'png' | 'webp' | 'image';
+};
+
+export type CdnParams = {
+  asThumbnail?: boolean;
+  transformation?: Transformation;
+};
+
+export type TransformationQueries = (params: Transformation) => string;
+
+type TwicpicsOutputTransformation = ['output', Transformation['output']];
+
+type TwicpicsFitTransformation = ['cover' | 'crop' | 'contain', string] | ['quality', number];
+
+export type TwicpicsTransformation = TwicpicsOutputTransformation | TwicpicsFitTransformation;
+
+export type TwicpicsTransformationChain = TwicpicsTransformation[];
+
+export type GetCdnUrl = (instanceId: string, path: `/${string}`, params?: CdnParams) => string;
+
+export type GetCdnFromS3Url = (url: string, params?: CdnParams) => string;
+
+export type InstanceMapper = (instanceId: string) => string;
+
+export type CdnType = 'twicpics' | 'imgix';
+
+export type CdnConfig<T extends CdnType> = {
+  type: T;
+  domain: `https://${string}`;
+  instanceMapper: InstanceMapper;
+  cacheVersion?: T extends 'twicpics' ? number : undefined;
+};
+
+export type Cdn = {
+  getCdnUrl: GetCdnUrl;
+  getCdnFromS3Url: GetCdnFromS3Url;
+};

package/src/cdn/types/index.ts

@@ -0,0 +1 @@
+export * from './cdn-factory.type';

package/src/cdn/utils/extract-info-from-url.util.ts

@@ -0,0 +1,25 @@
+type ExtractInfoFromUrl = (url: string) =>
+| {
+  instanceId: string;
+  path: `/${string}`;
+}
+| undefined;
+
+const S3_URL_RE = /https:\/\/sparted-prod-([^.]+)\.s3(\.eu-west-1)?(\.amazonaws\.com)?(\.fr-par\.scw\.cloud)?(\/[^?]+)/;
+
+export const extractInfoFromUrl: ExtractInfoFromUrl = (url) => {
+  if (typeof url !== 'string') {
+    return undefined;
+  }
+
+  const matchS3Url = url.match(S3_URL_RE);
+
+  if (!matchS3Url) {
+    return undefined;
+  }
+
+  const instanceId = matchS3Url[1];
+  const path = matchS3Url[5] as `/${string}`;
+
+  return { instanceId, path };
+};

package/src/cdn/utils/get-cdn-from-s3-url.util.ts

@@ -0,0 +1,20 @@
+import type { GetCdnFromS3Url, GetCdnUrl } from '../types';
+import { extractInfoFromUrl } from './extract-info-from-url.util';
+
+type FactoryConfig = {
+  getCdnUrl: GetCdnUrl;
+};
+
+export function getCdnFromS3UrlFactory(config: FactoryConfig): GetCdnFromS3Url {
+  return (url, params) => {
+    const { getCdnUrl } = config;
+
+    const info = extractInfoFromUrl(url);
+    if (info === undefined) {
+      return url;
+    }
+    const { instanceId, path } = info;
+
+    return getCdnUrl(instanceId, path, params);
+  };
+}