@docusaurus/plugin-client-redirects 2.0.0-beta.13 → 2.0.0-beta.15

package/src/__tests__/normalizePluginOptions.test.ts

@@ -1,71 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-import normalizePluginOptions, {
-  DefaultPluginOptions,
-} from '../normalizePluginOptions';
-import {CreateRedirectsFnOption} from '../types';
-
-describe('normalizePluginOptions', () => {
-  test('should return default options for undefined user options', () => {
-    expect(normalizePluginOptions()).toEqual(DefaultPluginOptions);
-  });
-
-  test('should return default options for empty user options', () => {
-    expect(normalizePluginOptions()).toEqual(DefaultPluginOptions);
-  });
-
-  test('should override one default options with valid user options', () => {
-    expect(
-      normalizePluginOptions({
-        toExtensions: ['html'],
-      }),
-    ).toEqual({...DefaultPluginOptions, toExtensions: ['html']});
-  });
-
-  test('should override all default options with valid user options', () => {
-    const createRedirects: CreateRedirectsFnOption = (_routePath: string) => [];
-    expect(
-      normalizePluginOptions({
-        fromExtensions: ['exe', 'zip'],
-        toExtensions: ['html'],
-        createRedirects,
-        redirects: [{from: '/x', to: '/y'}],
-      }),
-    ).toEqual({
-      id: 'default',
-      fromExtensions: ['exe', 'zip'],
-      toExtensions: ['html'],
-      createRedirects,
-      redirects: [{from: '/x', to: '/y'}],
-    });
-  });
-
-  test('should reject bad fromExtensions user inputs', () => {
-    expect(() =>
-      normalizePluginOptions({
-        fromExtensions: [null, undefined, 123, true] as unknown as string[],
-      }),
-    ).toThrowErrorMatchingSnapshot();
-  });
-
-  test('should reject bad toExtensions user inputs', () => {
-    expect(() =>
-      normalizePluginOptions({
-        toExtensions: [null, undefined, 123, true] as unknown as string[],
-      }),
-    ).toThrowErrorMatchingSnapshot();
-  });
-
-  test('should reject bad createRedirects user inputs', () => {
-    expect(() =>
-      normalizePluginOptions({
-        createRedirects: ['bad', 'value'] as unknown as CreateRedirectsFnOption,
-      }),
-    ).toThrowErrorMatchingSnapshot();
-  });
-});

package/src/__tests__/redirectValidation.test.ts

@@ -1,66 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-import {validateRedirect} from '../redirectValidation';
-
-describe('validateRedirect', () => {
-  test('validate good redirects without throwing', () => {
-    validateRedirect({
-      from: '/fromSomePath',
-      to: '/toSomePath',
-    });
-    validateRedirect({
-      from: '/from/Some/Path',
-      to: '/toSomePath',
-    });
-    validateRedirect({
-      from: '/fromSomePath',
-      to: '/toSomePath',
-    });
-    validateRedirect({
-      from: '/fromSomePath',
-      to: '/to/Some/Path',
-    });
-  });
-
-  test('throw for bad redirects', () => {
-    expect(() =>
-      validateRedirect({
-        from: 'https://fb.com/fromSomePath',
-        to: '/toSomePath',
-      }),
-    ).toThrowErrorMatchingSnapshot();
-
-    expect(() =>
-      validateRedirect({
-        from: '/fromSomePath',
-        to: 'https://fb.com/toSomePath',
-      }),
-    ).toThrowErrorMatchingSnapshot();
-
-    expect(() =>
-      validateRedirect({
-        from: '/fromSomePath',
-        to: '/toSomePath?queryString=xyz',
-      }),
-    ).toThrowErrorMatchingSnapshot();
-
-    expect(() =>
-      validateRedirect({
-        from: null as unknown as string,
-        to: '/toSomePath?queryString=xyz',
-      }),
-    ).toThrowErrorMatchingSnapshot();
-
-    expect(() =>
-      validateRedirect({
-        from: ['heyho'] as unknown as string,
-        to: '/toSomePath?queryString=xyz',
-      }),
-    ).toThrowErrorMatchingSnapshot();
-  });
-});

package/src/__tests__/writeRedirectFiles.test.ts

@@ -1,205 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-import fs from 'fs-extra';
-import path from 'path';
-
-import writeRedirectFiles, {
-  toRedirectFilesMetadata,
-  createToUrl,
-} from '../writeRedirectFiles';
-
-// Test to fix toUrl bugs we had:
-// - https://github.com/facebook/docusaurus/issues/3886
-// - https://github.com/facebook/docusaurus/issues/3925
-describe('createToUrl', () => {
-  test('should create appropriate redirect urls', async () => {
-    expect(createToUrl('/', '/docs/something/else')).toEqual(
-      '/docs/something/else',
-    );
-    expect(createToUrl('/', '/docs/something/else/')).toEqual(
-      '/docs/something/else/',
-    );
-    expect(createToUrl('/', 'docs/something/else')).toEqual(
-      '/docs/something/else',
-    );
-  });
-
-  test('should create appropriate redirect urls with baseUrl', async () => {
-    expect(createToUrl('/baseUrl/', '/docs/something/else')).toEqual(
-      '/baseUrl/docs/something/else',
-    );
-    expect(createToUrl('/baseUrl/', '/docs/something/else/')).toEqual(
-      '/baseUrl/docs/something/else/',
-    );
-    expect(createToUrl('/baseUrl/', 'docs/something/else')).toEqual(
-      '/baseUrl/docs/something/else',
-    );
-  });
-});
-
-describe('toRedirectFilesMetadata', () => {
-  test('should create appropriate metadata trailingSlash=undefined', async () => {
-    const pluginContext = {
-      outDir: '/tmp/someFixedOutDir',
-      baseUrl: 'https://docusaurus.io',
-    };
-
-    const redirectFiles = toRedirectFilesMetadata(
-      [
-        {from: '/abc.html', to: '/abc'},
-        {from: '/def', to: '/def.html'},
-        {from: '/xyz', to: '/'},
-      ],
-      pluginContext,
-      undefined,
-    );
-
-    expect(redirectFiles.map((f) => f.fileAbsolutePath)).toEqual([
-      path.join(pluginContext.outDir, '/abc.html/index.html'),
-      path.join(pluginContext.outDir, '/def/index.html'),
-      path.join(pluginContext.outDir, '/xyz/index.html'),
-    ]);
-
-    expect(redirectFiles.map((f) => f.fileContent)).toMatchSnapshot(
-      'fileContent',
-    );
-  });
-
-  test('should create appropriate metadata trailingSlash=true', async () => {
-    const pluginContext = {
-      outDir: '/tmp/someFixedOutDir',
-      baseUrl: 'https://docusaurus.io',
-    };
-
-    const redirectFiles = toRedirectFilesMetadata(
-      [
-        {from: '/abc.html', to: '/abc'},
-        {from: '/def', to: '/def.html'},
-        {from: '/xyz', to: '/'},
-      ],
-      pluginContext,
-      true,
-    );
-
-    expect(redirectFiles.map((f) => f.fileAbsolutePath)).toEqual([
-      path.join(pluginContext.outDir, '/abc.html/index.html'),
-      path.join(pluginContext.outDir, '/def/index.html'),
-      path.join(pluginContext.outDir, '/xyz/index.html'),
-    ]);
-
-    expect(redirectFiles.map((f) => f.fileContent)).toMatchSnapshot(
-      'fileContent',
-    );
-  });
-
-  test('should create appropriate metadata trailingSlash=false', async () => {
-    const pluginContext = {
-      outDir: '/tmp/someFixedOutDir',
-      baseUrl: 'https://docusaurus.io',
-    };
-
-    const redirectFiles = toRedirectFilesMetadata(
-      [
-        {from: '/abc.html', to: '/abc'},
-        {from: '/def', to: '/def.html'},
-        {from: '/xyz', to: '/'},
-      ],
-      pluginContext,
-      false,
-    );
-
-    expect(redirectFiles.map((f) => f.fileAbsolutePath)).toEqual([
-      // path.join(pluginContext.outDir, '/abc.html/index.html'), // Can't be used because /abc.html already exists, and file/folder can't share same name on Unix!
-      path.join(pluginContext.outDir, '/abc.html.html'), // Weird but on purpose!
-      path.join(pluginContext.outDir, '/def/index.html'),
-      path.join(pluginContext.outDir, '/xyz/index.html'),
-    ]);
-
-    expect(redirectFiles.map((f) => f.fileContent)).toMatchSnapshot(
-      'fileContent',
-    );
-  });
-
-  test('should create appropriate metadata for root baseUrl', async () => {
-    const pluginContext = {
-      outDir: '/tmp/someFixedOutDir',
-      baseUrl: '/',
-    };
-    const redirectFiles = toRedirectFilesMetadata(
-      [{from: '/abc.html', to: '/abc'}],
-      pluginContext,
-      undefined,
-    );
-    expect(redirectFiles.map((f) => f.fileContent)).toMatchSnapshot(
-      'fileContent baseUrl=/',
-    );
-  });
-
-  test('should create appropriate metadata for empty baseUrl', async () => {
-    const pluginContext = {
-      outDir: '/tmp/someFixedOutDir',
-      baseUrl: '',
-    };
-    const redirectFiles = toRedirectFilesMetadata(
-      [{from: '/abc.html', to: '/abc'}],
-      pluginContext,
-      undefined,
-    );
-    expect(redirectFiles.map((f) => f.fileContent)).toMatchSnapshot(
-      'fileContent baseUrl=empty',
-    );
-  });
-});
-
-describe('writeRedirectFiles', () => {
-  test('write the files', async () => {
-    const outDir = `/tmp/docusaurus_tests_${Math.random()}`;
-
-    const filesMetadata = [
-      {
-        fileAbsolutePath: path.join(outDir, 'someFileName'),
-        fileContent: 'content 1',
-      },
-      {
-        fileAbsolutePath: path.join(outDir, '/some/nested/filename'),
-        fileContent: 'content 2',
-      },
-    ];
-
-    await writeRedirectFiles(filesMetadata);
-
-    await expect(
-      fs.readFile(filesMetadata[0].fileAbsolutePath, 'utf8'),
-    ).resolves.toEqual('content 1');
-
-    await expect(
-      fs.readFile(filesMetadata[1].fileAbsolutePath, 'utf8'),
-    ).resolves.toEqual('content 2');
-  });
-
-  test('avoid overwriting existing files', async () => {
-    const outDir = `/tmp/docusaurus_tests_${Math.random()}`;
-
-    const filesMetadata = [
-      {
-        fileAbsolutePath: path.join(outDir, 'someFileName/index.html'),
-        fileContent: 'content 1',
-      },
-    ];
-
-    await fs.ensureDir(path.dirname(filesMetadata[0].fileAbsolutePath));
-    await fs.writeFile(
-      filesMetadata[0].fileAbsolutePath,
-      'file already exists!',
-    );
-
-    await expect(writeRedirectFiles(filesMetadata)).rejects.toThrowError(
-      `Redirect file creation error for "${filesMetadata[0].fileAbsolutePath}" path: Error: The redirect plugin is not supposed to override existing files.`,
-    );
-  });
-});

package/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "incremental": true,
-    "tsBuildInfoFile": "./lib/.tsbuildinfo",
-    "rootDir": "src",
-    "outDir": "lib",
-    "typeRoots": ["./types", "./node_modules/@types"]
-  }
-}