@docusaurus/plugin-client-redirects 0.0.0-4727 → 0.0.0-4728

package/lib/index.d.ts

@@ -6,4 +6,5 @@
  */
 import type { LoadContext, Plugin } from '@docusaurus/types';
 import type { PluginOptions } from '@docusaurus/plugin-client-redirects';
-export default function pluginClientRedirectsPages(context: LoadContext, opts: PluginOptions): Plugin<unknown>;
+export default function pluginClientRedirectsPages(context: LoadContext, options: PluginOptions): Plugin<unknown>;
+export { validateOptions } from './options';

package/lib/index.js

@@ -6,14 +6,13 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateOptions = void 0;
 const tslib_1 = require("tslib");
-const normalizePluginOptions_1 = tslib_1.__importDefault(require("./normalizePluginOptions"));
 const collectRedirects_1 = tslib_1.__importDefault(require("./collectRedirects"));
 const writeRedirectFiles_1 = tslib_1.__importStar(require("./writeRedirectFiles"));
 const utils_1 = require("@docusaurus/utils");
-function pluginClientRedirectsPages(context, opts) {
+function pluginClientRedirectsPages(context, options) {
     const { trailingSlash } = context.siteConfig;
-    const options = (0, normalizePluginOptions_1.default)(opts);
     return {
         name: 'docusaurus-plugin-client-redirects',
         async postBuild(props) {
@@ -31,3 +30,5 @@ function pluginClientRedirectsPages(context, opts) {
     };
 }
 exports.default = pluginClientRedirectsPages;
+var options_1 = require("./options");
+Object.defineProperty(exports, "validateOptions", { enumerable: true, get: function () { return options_1.validateOptions; } });

package/lib/options.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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 type { PluginOptions } from '@docusaurus/plugin-client-redirects';
+import type { OptionValidationContext, ValidationResult } from '@docusaurus/types';
+export declare const DEFAULT_OPTIONS: Partial<PluginOptions>;
+export declare function validateOptions({ validate, options: userOptions, }: OptionValidationContext<PluginOptions>): ValidationResult<PluginOptions>;

package/lib/options.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateOptions = exports.DEFAULT_OPTIONS = void 0;
+const utils_validation_1 = require("@docusaurus/utils-validation");
+exports.DEFAULT_OPTIONS = {
+    fromExtensions: [],
+    toExtensions: [],
+    redirects: [],
+};
+const RedirectPluginOptionValidation = utils_validation_1.Joi.object({
+    to: utils_validation_1.PathnameSchema.required(),
+    from: utils_validation_1.Joi.alternatives().try(utils_validation_1.PathnameSchema.required(), utils_validation_1.Joi.array().items(utils_validation_1.PathnameSchema.required())),
+});
+const isString = utils_validation_1.Joi.string().required().not(null);
+const UserOptionsSchema = utils_validation_1.Joi.object({
+    fromExtensions: utils_validation_1.Joi.array()
+        .items(isString)
+        .default(exports.DEFAULT_OPTIONS.fromExtensions),
+    toExtensions: utils_validation_1.Joi.array()
+        .items(isString)
+        .default(exports.DEFAULT_OPTIONS.toExtensions),
+    redirects: utils_validation_1.Joi.array()
+        .items(RedirectPluginOptionValidation)
+        .default(exports.DEFAULT_OPTIONS.redirects),
+    createRedirects: utils_validation_1.Joi.function().arity(1),
+}).default(exports.DEFAULT_OPTIONS);
+function validateOptions({ validate, options: userOptions, }) {
+    return validate(UserOptionsSchema, userOptions);
+}
+exports.validateOptions = validateOptions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-client-redirects",
-  "version": "0.0.0-4727",
+  "version": "0.0.0-4728",
   "description": "Client redirects plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-client-redirects.d.ts",
@@ -18,18 +18,18 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "0.0.0-4727",
-    "@docusaurus/logger": "0.0.0-4727",
-    "@docusaurus/utils": "0.0.0-4727",
-    "@docusaurus/utils-common": "0.0.0-4727",
-    "@docusaurus/utils-validation": "0.0.0-4727",
+    "@docusaurus/core": "0.0.0-4728",
+    "@docusaurus/logger": "0.0.0-4728",
+    "@docusaurus/utils": "0.0.0-4728",
+    "@docusaurus/utils-common": "0.0.0-4728",
+    "@docusaurus/utils-validation": "0.0.0-4728",
     "eta": "^1.12.3",
     "fs-extra": "^10.0.1",
     "lodash": "^4.17.21",
     "tslib": "^2.3.1"
   },
   "devDependencies": {
-    "@docusaurus/types": "0.0.0-4727"
+    "@docusaurus/types": "0.0.0-4728"
   },
   "peerDependencies": {
     "react": "^16.8.4 || ^17.0.0",
@@ -38,5 +38,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "967bfff81002933a1c68980300233e0320398e04"
+  "gitHead": "517f5b73eaacc1002a973074567a321b469868fe"
 }

package/src/index.ts

@@ -9,7 +9,6 @@ import type {LoadContext, Plugin, Props} from '@docusaurus/types';
 import type {PluginContext, RedirectMetadata} from './types';
 import type {PluginOptions} from '@docusaurus/plugin-client-redirects';
 
-import normalizePluginOptions from './normalizePluginOptions';
 import collectRedirects from './collectRedirects';
 import writeRedirectFiles, {
   toRedirectFilesMetadata,
@@ -19,12 +18,10 @@ import {removePrefix, addLeadingSlash} from '@docusaurus/utils';
 
 export default function pluginClientRedirectsPages(
   context: LoadContext,
-  opts: PluginOptions,
+  options: PluginOptions,
 ): Plugin<unknown> {
   const {trailingSlash} = context.siteConfig;
 
-  const options = normalizePluginOptions(opts);
-
   return {
     name: 'docusaurus-plugin-client-redirects',
     async postBuild(props: Props) {
@@ -53,3 +50,5 @@ export default function pluginClientRedirectsPages(
     },
   };
 }
+
+export {validateOptions} from './options';

package/src/options.ts

@@ -0,0 +1,52 @@
+/**
+ * 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 type {
+  PluginOptions,
+  RedirectOption,
+} from '@docusaurus/plugin-client-redirects';
+import type {
+  OptionValidationContext,
+  ValidationResult,
+} from '@docusaurus/types';
+import {Joi, PathnameSchema} from '@docusaurus/utils-validation';
+
+export const DEFAULT_OPTIONS: Partial<PluginOptions> = {
+  fromExtensions: [],
+  toExtensions: [],
+  redirects: [],
+};
+
+const RedirectPluginOptionValidation = Joi.object<RedirectOption>({
+  to: PathnameSchema.required(),
+  from: Joi.alternatives().try(
+    PathnameSchema.required(),
+    Joi.array().items(PathnameSchema.required()),
+  ),
+});
+
+const isString = Joi.string().required().not(null);
+
+const UserOptionsSchema = Joi.object<PluginOptions>({
+  fromExtensions: Joi.array()
+    .items(isString)
+    .default(DEFAULT_OPTIONS.fromExtensions),
+  toExtensions: Joi.array()
+    .items(isString)
+    .default(DEFAULT_OPTIONS.toExtensions),
+  redirects: Joi.array()
+    .items(RedirectPluginOptionValidation)
+    .default(DEFAULT_OPTIONS.redirects),
+  createRedirects: Joi.function().arity(1),
+}).default(DEFAULT_OPTIONS);
+
+export function validateOptions({
+  validate,
+  options: userOptions,
+}: OptionValidationContext<PluginOptions>): ValidationResult<PluginOptions> {
+  return validate(UserOptionsSchema, userOptions);
+}

package/lib/normalizePluginOptions.d.ts

@@ -1,9 +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 type { PluginOptions, Options as UserPluginOptions } from '@docusaurus/plugin-client-redirects';
-export declare const DefaultPluginOptions: PluginOptions;
-export default function normalizePluginOptions(userPluginOptions?: UserPluginOptions): PluginOptions;

package/lib/normalizePluginOptions.js

@@ -1,44 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefaultPluginOptions = void 0;
-const utils_validation_1 = require("@docusaurus/utils-validation");
-const utils_1 = require("@docusaurus/utils");
-exports.DefaultPluginOptions = {
-    id: utils_1.DEFAULT_PLUGIN_ID,
-    fromExtensions: [],
-    toExtensions: [],
-    redirects: [],
-};
-const RedirectPluginOptionValidation = utils_validation_1.Joi.object({
-    to: utils_validation_1.PathnameSchema.required(),
-    from: utils_validation_1.Joi.alternatives().try(utils_validation_1.PathnameSchema.required(), utils_validation_1.Joi.array().items(utils_validation_1.PathnameSchema.required())),
-});
-const isString = utils_validation_1.Joi.string().required().not(null);
-const UserOptionsSchema = utils_validation_1.Joi.object({
-    id: utils_validation_1.Joi.string().optional(),
-    fromExtensions: utils_validation_1.Joi.array().items(isString),
-    toExtensions: utils_validation_1.Joi.array().items(isString),
-    redirects: utils_validation_1.Joi.array().items(RedirectPluginOptionValidation),
-    createRedirects: utils_validation_1.Joi.function().arity(1),
-});
-function validateUserOptions(userOptions) {
-    const { error } = UserOptionsSchema.validate(userOptions, {
-        abortEarly: true,
-        allowUnknown: false,
-    });
-    if (error) {
-        throw new Error(`Invalid @docusaurus/plugin-client-redirects options: ${error.message}
-  ${JSON.stringify(userOptions, null, 2)}`);
-    }
-}
-function normalizePluginOptions(userPluginOptions = {}) {
-    validateUserOptions(userPluginOptions);
-    return { ...exports.DefaultPluginOptions, ...userPluginOptions };
-}
-exports.default = normalizePluginOptions;

package/src/normalizePluginOptions.ts

@@ -1,59 +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 type {
-  PluginOptions,
-  Options as UserPluginOptions,
-  RedirectOption,
-} from '@docusaurus/plugin-client-redirects';
-import {Joi, PathnameSchema} from '@docusaurus/utils-validation';
-import {DEFAULT_PLUGIN_ID} from '@docusaurus/utils';
-
-export const DefaultPluginOptions: PluginOptions = {
-  id: DEFAULT_PLUGIN_ID, // TODO temporary
-  fromExtensions: [],
-  toExtensions: [],
-  redirects: [],
-};
-
-const RedirectPluginOptionValidation = Joi.object<RedirectOption>({
-  to: PathnameSchema.required(),
-  from: Joi.alternatives().try(
-    PathnameSchema.required(),
-    Joi.array().items(PathnameSchema.required()),
-  ),
-});
-
-const isString = Joi.string().required().not(null);
-
-const UserOptionsSchema = Joi.object<UserPluginOptions>({
-  id: Joi.string().optional(), // TODO remove once validation migrated to new system
-  fromExtensions: Joi.array().items(isString),
-  toExtensions: Joi.array().items(isString),
-  redirects: Joi.array().items(RedirectPluginOptionValidation),
-  createRedirects: Joi.function().arity(1),
-});
-
-function validateUserOptions(userOptions: UserPluginOptions) {
-  const {error} = UserOptionsSchema.validate(userOptions, {
-    abortEarly: true,
-    allowUnknown: false,
-  });
-  if (error) {
-    throw new Error(
-      `Invalid @docusaurus/plugin-client-redirects options: ${error.message}
-  ${JSON.stringify(userOptions, null, 2)}`,
-    );
-  }
-}
-
-export default function normalizePluginOptions(
-  userPluginOptions: UserPluginOptions = {},
-): PluginOptions {
-  validateUserOptions(userPluginOptions);
-  return {...DefaultPluginOptions, ...userPluginOptions};
-}