@defra/forms-engine-plugin 0.1.19 → 0.1.21

package/.server/server/plugins/engine/services/formsService.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Dummy function to get form metadata.
+ * @param {string} _slug - the slug of the form
+ * @returns {Promise<FormMetadata>}
+ */
+export function getFormMetadata(_slug: string): Promise<FormMetadata>;
+/**
+ * Dummy function to get form metadata.
+ * @param {string} _id - the id of the form
+ * @param {FormStatus} _state - the state of the form
+ * @returns {Promise<FormDefinition | undefined>}
+ */
+export function getFormDefinition(_id: string, _state: FormStatus): Promise<FormDefinition | undefined>;
+import type { FormMetadata } from '@defra/forms-model';
+import type { FormStatus } from '@defra/forms-model';
+import type { FormDefinition } from '@defra/forms-model';

package/.server/server/plugins/engine/services/index.d.ts

@@ -0,0 +1,3 @@
+export * as formsService from "~/src/server/plugins/engine/services/formsService.js";
+export * as formSubmissionService from "~/src/server/plugins/engine/services/formSubmissionService.js";
+export * as outputService from "~/src/server/plugins/engine/services/notifyService.js";

package/.server/server/plugins/engine/services/localFormsService.d.ts

@@ -0,0 +1 @@
+export function formsService(): Promise<import("../../../types.js").FormsService>;

package/.server/server/plugins/engine/services/notifyService.d.ts

@@ -0,0 +1,5 @@
+import { type SubmitResponsePayload } from '@defra/forms-model';
+import { type FormModel } from '~/src/server/plugins/engine/models/index.js';
+import { type DetailItem } from '~/src/server/plugins/engine/models/types.js';
+import { type FormRequestPayload } from '~/src/server/routes/types.js';
+export declare function submit(request: FormRequestPayload, model: FormModel, emailAddress: string, items: DetailItem[], submitResponse: SubmitResponsePayload): Promise<void>;

package/.server/server/plugins/engine/services/uploadService.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Initiates a CDP file upload
+ * @param {string} path - the path of the page in the form
+ * @param {string} retrievalKey - the retrieval key for the files
+ * @param {string} [mimeTypesCsv] - the csv string of accepted mimeTypes
+ */
+export function initiateUpload(path: string, retrievalKey: string, mimeTypesCsv?: string): Promise<UploadInitiateResponse | undefined>;
+/**
+ * Get the status of a CDP file upload
+ * @param {string} uploadId - the ID of the upload
+ */
+export function getUploadStatus(uploadId: string): Promise<UploadStatusResponse | undefined>;
+import type { UploadInitiateResponse } from '~/src/server/plugins/engine/types.js';
+import type { UploadStatusResponse } from '~/src/server/plugins/engine/types.js';

package/.server/server/plugins/engine/types.d.ts

@@ -0,0 +1,256 @@
+import { type ComponentDef, type Item, type List, type Page } from '@defra/forms-model';
+import { type JoiExpression, type ValidationErrorItem } from 'joi';
+import { type Component } from '~/src/server/plugins/engine/components/helpers.js';
+import { type BackLink, type ComponentText, type ComponentViewModel } from '~/src/server/plugins/engine/components/types.js';
+import { type PageController } from '~/src/server/plugins/engine/pageControllers/PageController.js';
+import { type PageControllerClass } from '~/src/server/plugins/engine/pageControllers/helpers.js';
+import { type ViewContext } from '~/src/server/plugins/nunjucks/types.js';
+import { type FormAction, type FormRequest } from '~/src/server/routes/types.js';
+/**
+ * Form submission state stores the following in Redis:
+ * Props containing user's submitted values as `{ [inputId]: value }` or as `{ [sectionName]: { [inputName]: value } }`
+ *   a) . e.g:
+ * ```ts
+ *     {
+ *       _C9PRHmsgt: 'Ben',
+ *       WfLk9McjzX: 'Music',
+ *       IK7jkUFCBL: 'Royal Academy of Music'
+ *     }
+ * ```
+ *
+ *   b)
+ * ```ts
+ *   {
+ *         checkBeforeYouStart: { ukPassport: true },
+ *         applicantDetails: {
+ *           numberOfApplicants: 1,
+ *           phoneNumber: '77777777',
+ *           emailAddress: 'aaa@aaa.com'
+ *         },
+ *         applicantOneDetails: {
+ *           firstName: 'a',
+ *           middleName: 'a',
+ *           lastName: 'a',
+ *           address: { addressLine1: 'a', addressLine2: 'a', town: 'a', postcode: 'a' }
+ *         }
+ *     }
+ * ```
+ */
+/**
+ * Form submission state
+ */
+export type FormSubmissionState = {
+    upload?: Record<string, TempFileState>;
+} & FormState;
+export interface FormSubmissionError extends Pick<ValidationErrorItem, 'context' | 'path'> {
+    href: string;
+    name: string;
+    text: string;
+}
+export interface FormParams {
+    action?: FormAction;
+    confirm?: true;
+    crumb?: string;
+    itemId?: string;
+}
+/**
+ * Form POST for question pages
+ * (after Joi has converted value types)
+ */
+export type FormPayload = FormParams & Partial<Record<string, FormValue>>;
+export type FormValue = Item['value'] | Item['value'][] | UploadState | RepeatListState | undefined;
+export type FormState = Partial<Record<string, FormStateValue>>;
+export type FormStateValue = Exclude<FormValue, undefined> | null;
+export interface FormValidationResult<ValueType extends FormPayload | FormSubmissionState> {
+    value: ValueType;
+    errors: FormSubmissionError[] | undefined;
+}
+export interface FormContext {
+    /**
+     * Evaluation form state only (filtered by visited paths),
+     * with values formatted for condition evaluation using
+     * {@link FormComponent.getContextValueFromState}
+     */
+    evaluationState: FormState;
+    /**
+     * Relevant form state only (filtered by visited paths)
+     */
+    relevantState: FormState;
+    /**
+     * Relevant pages only (filtered by visited paths)
+     */
+    relevantPages: PageControllerClass[];
+    /**
+     * Form submission payload (single page)
+     */
+    payload: FormPayload;
+    /**
+     * Form submission state (entire form)
+     */
+    state: FormSubmissionState;
+    /**
+     * Validation errors (entire form)
+     */
+    errors?: FormSubmissionError[];
+    /**
+     * Visited paths evaluated from form state
+     */
+    paths: string[];
+    /**
+     * Preview URL direct access is allowed
+     */
+    isForceAccess: boolean;
+    /**
+     * Miscellaneous extra data from event responses
+     */
+    data: object;
+    pageDefMap: Map<string, Page>;
+    listDefMap: Map<string, List>;
+    componentDefMap: Map<string, ComponentDef>;
+    pageMap: Map<string, PageControllerClass>;
+    componentMap: Map<string, Component>;
+    referenceNumber: string;
+}
+export type FormContextRequest = ({
+    method: 'get';
+    payload?: undefined;
+} | {
+    method: 'post';
+    payload: FormPayload;
+} | {
+    method: FormRequest['method'];
+    payload?: object | undefined;
+}) & Pick<FormRequest, 'app' | 'method' | 'params' | 'path' | 'query' | 'url'>;
+export interface UploadInitiateResponse {
+    uploadId: string;
+    uploadUrl: string;
+    statusUrl: string;
+}
+export declare enum UploadStatus {
+    initiated = "initiated",
+    pending = "pending",
+    ready = "ready"
+}
+export declare enum FileStatus {
+    complete = "complete",
+    rejected = "rejected",
+    pending = "pending"
+}
+export type UploadState = FileState[];
+export type FileUpload = {
+    fileId: string;
+    filename: string;
+    contentLength: number;
+} & ({
+    fileStatus: FileStatus.complete | FileStatus.rejected | FileStatus.pending;
+    errorMessage?: string;
+} | {
+    fileStatus: FileStatus.complete;
+    errorMessage?: undefined;
+});
+export interface FileUploadMetadata {
+    retrievalKey: string;
+}
+export type UploadStatusResponse = {
+    uploadStatus: UploadStatus.initiated;
+    metadata: FileUploadMetadata;
+    form: {
+        file?: undefined;
+    };
+} | {
+    uploadStatus: UploadStatus.pending | UploadStatus.ready;
+    metadata: FileUploadMetadata;
+    form: {
+        file: FileUpload;
+    };
+    numberOfRejectedFiles?: number;
+} | {
+    uploadStatus: UploadStatus.ready;
+    metadata: FileUploadMetadata;
+    form: {
+        file: FileUpload;
+    };
+    numberOfRejectedFiles: 0;
+};
+export type UploadStatusFileResponse = Exclude<UploadStatusResponse, {
+    uploadStatus: UploadStatus.initiated;
+}>;
+export interface FileState {
+    uploadId: string;
+    status: UploadStatusFileResponse;
+}
+export interface TempFileState {
+    upload?: UploadInitiateResponse;
+    files: UploadState;
+}
+export interface RepeatItemState extends FormPayload {
+    itemId: string;
+}
+export type RepeatListState = RepeatItemState[];
+export interface CheckAnswers {
+    title?: ComponentText;
+    summaryList: SummaryList;
+}
+export interface SummaryList {
+    classes?: string;
+    rows: SummaryListRow[];
+}
+export interface SummaryListRow {
+    key: ComponentText;
+    value: ComponentText;
+    actions?: {
+        items: SummaryListAction[];
+    };
+}
+export type SummaryListAction = ComponentText & {
+    href: string;
+    visuallyHiddenText: string;
+};
+export interface PageViewModelBase extends Partial<ViewContext> {
+    page: PageController;
+    name?: string;
+    pageTitle: string;
+    sectionTitle?: string;
+    showTitle: boolean;
+    isStartPage: boolean;
+    backLink?: BackLink;
+    feedbackLink?: string;
+    serviceUrl: string;
+    phaseTag?: string;
+}
+export interface ItemDeletePageViewModel extends PageViewModelBase {
+    context: FormContext;
+    itemTitle: string;
+    confirmation?: ComponentText;
+    buttonConfirm: ComponentText;
+    buttonCancel: ComponentText;
+}
+export interface FormPageViewModel extends PageViewModelBase {
+    components: ComponentViewModel[];
+    context: FormContext;
+    errors?: FormSubmissionError[];
+    hasMissingNotificationEmail?: boolean;
+}
+export interface RepeaterSummaryPageViewModel extends PageViewModelBase {
+    context: FormContext;
+    errors?: FormSubmissionError[];
+    checkAnswers: CheckAnswers[];
+    repeatTitle: string;
+}
+export interface FeaturedFormPageViewModel extends FormPageViewModel {
+    formAction?: string;
+    formComponent: ComponentViewModel;
+    componentsBefore: ComponentViewModel[];
+    uploadId: string | undefined;
+    proxyUrl: string | null;
+}
+export type PageViewModel = PageViewModelBase | ItemDeletePageViewModel | FormPageViewModel | RepeaterSummaryPageViewModel | FeaturedFormPageViewModel;
+export type FilterFunction = (value: unknown) => unknown;
+export interface ErrorMessageTemplate {
+    type: string;
+    template: JoiExpression;
+}
+export interface ErrorMessageTemplateList {
+    baseErrors: ErrorMessageTemplate[];
+    advancedSettingsErrors: ErrorMessageTemplate[];
+}

package/.server/server/plugins/errorPages.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+    plugin: {
+        name: string;
+        register(server: import("@hapi/hapi").Server<import("@hapi/hapi").ServerApplicationState>): void;
+    };
+};
+export default _default;

package/.server/server/plugins/nunjucks/context.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @param {FormRequest | FormRequestPayload | null} request
+ */
+export function context(request: FormRequest | FormRequestPayload | null): Promise<ViewContext>;
+/**
+ * Returns the context for the devtool. Consumers won't have access to this.
+ * @param {FormRequest | FormRequestPayload | null} _request
+ * @returns {Record<string, unknown> & { assetPath: string, getDxtAssetPath: (asset: string) => string }}
+ */
+export function devtoolContext(_request: FormRequest | FormRequestPayload | null): Record<string, unknown> & {
+    assetPath: string;
+    getDxtAssetPath: (asset: string) => string;
+};
+import type { FormRequest } from '~/src/server/routes/types.js';
+import type { FormRequestPayload } from '~/src/server/routes/types.js';
+import type { ViewContext } from '~/src/server/plugins/nunjucks/types.js';

package/.server/server/plugins/nunjucks/environment.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @this {NunjucksContext}
+ * @param {FormSubmissionError[]} errors
+ */
+export function checkErrorTemplates(this: NunjucksContext, errors: FormSubmissionError[]): FormSubmissionError[];
+/**
+ * @this {NunjucksContext}
+ * @param {ComponentViewModel} component
+ */
+export function checkComponentTemplates(this: NunjucksContext, component: ComponentViewModel): ComponentViewModel;
+/**
+ * @this {NunjucksContext}
+ * @param {string} template
+ */
+export function evaluate(this: NunjucksContext, template: string): string;
+export const paths: string[];
+export const environment: nunjucks.Environment;
+import type { FormSubmissionError } from '~/src/server/plugins/engine/types.js';
+import type { NunjucksContext } from '~/src/server/plugins/nunjucks/types.js';
+import type { ComponentViewModel } from '~/src/server/plugins/engine/components/types.js';
+import nunjucks from 'nunjucks';

package/.server/server/plugins/nunjucks/filters/answer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Nunjucks filter to get the answer for a component
+ * @this {NunjucksContext}
+ * @param {string} name - The name of the component to check
+ */
+export function answer(this: NunjucksContext, name: string): string | undefined;
+import type { NunjucksContext } from '~/src/server/plugins/nunjucks/types.js';

package/.server/server/plugins/nunjucks/filters/evaluate.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Nunjucks filter to evaluate a liquid template.
+ * Currently just used in `src/server/views/layout.html#LN37` for the pageTitle
+ * @this {NunjucksContext}
+ * @param {string} template
+ */
+export function evaluate(this: NunjucksContext, template: string): string;
+import type { NunjucksContext } from '~/src/server/plugins/nunjucks/types.js';

package/.server/server/plugins/nunjucks/filters/field.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Nunjucks filter to get the answer for a component
+ * @this {NunjucksContext}
+ * @param {string} name - The name of the component
+ */
+export function field(this: NunjucksContext, name: string): import("../../engine/components/SelectField.js").SelectField | import("../../engine/components/RadiosField.js").RadiosField | import("../../engine/components/YesNoField.js").YesNoField | import("../../engine/components/CheckboxesField.js").CheckboxesField | import("../../engine/components/DatePartsField.js").DatePartsField | import("../../engine/components/EmailAddressField.js").EmailAddressField | import("../../engine/components/MonthYearField.js").MonthYearField | import("../../engine/components/MultilineTextField.js").MultilineTextField | import("../../engine/components/NumberField.js").NumberField | import("../../engine/components/TelephoneNumberField.js").TelephoneNumberField | import("../../engine/components/TextField.js").TextField | import("../../engine/components/UkAddressField.js").UkAddressField | import("../../engine/components/FileUploadField.js").FileUploadField | import("../../engine/components/Details.js").Details | import("../../engine/components/Html.js").Html | import("../../engine/components/InsetText.js").InsetText | import("../../engine/components/List.js").List | import("../../engine/components/Markdown.js").Markdown | undefined;
+import type { NunjucksContext } from '~/src/server/plugins/nunjucks/types.js';

package/.server/server/plugins/nunjucks/filters/highlight.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Format code with syntax highlighting
+ * @param {string} code - Code in plain text
+ * @param {string} [language] - Code programming language
+ * @returns {string} Code with syntax highlighting
+ */
+export function highlight(code: string, language?: string): string;

package/.server/server/plugins/nunjucks/filters/href.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Nunjucks filter to get the answer for a component
+ * @this {NunjucksContext}
+ * @param {string} path - The name of the component
+ */
+export function href(this: NunjucksContext, path: string): string | undefined;
+import type { NunjucksContext } from '~/src/server/plugins/nunjucks/types.js';

package/.server/server/plugins/nunjucks/filters/index.d.ts

@@ -0,0 +1,8 @@
+export { markdownToHtml as markdown } from "@defra/forms-model";
+export { highlight } from "~/src/server/plugins/nunjucks/filters/highlight.js";
+export { inspect } from "~/src/server/plugins/nunjucks/filters/inspect.js";
+export { evaluate } from "~/src/server/plugins/nunjucks/filters/evaluate.js";
+export { answer } from "~/src/server/plugins/nunjucks/filters/answer.js";
+export { href } from "~/src/server/plugins/nunjucks/filters/href.js";
+export { field } from "~/src/server/plugins/nunjucks/filters/field.js";
+export { page } from "~/src/server/plugins/nunjucks/filters/page.js";

package/.server/server/plugins/nunjucks/filters/inspect.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Format JavaScript objects as strings
+ * @param {unknown} object - JavaScript object to format
+ * @returns {string} Formatted string
+ */
+export function inspect(object: unknown): string;

package/.server/server/plugins/nunjucks/filters/page.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Nunjucks filter to get the page for a given path
+ * @this {NunjucksContext}
+ * @param {string} path - The path of the page
+ */
+export function page(this: NunjucksContext, path: string): import("../../engine/pageControllers/QuestionPageController.js").QuestionPageController | import("../../engine/pageControllers/StartPageController.js").StartPageController | import("../../engine/pageControllers/RepeatPageController.js").RepeatPageController | undefined;
+import type { NunjucksContext } from '~/src/server/plugins/nunjucks/types.js';

package/.server/server/plugins/nunjucks/index.d.ts

@@ -0,0 +1,3 @@
+export * as render from "~/src/server/plugins/nunjucks/render.js";
+export { environment } from "~/src/server/plugins/nunjucks/environment.js";
+export { plugin } from "~/src/server/plugins/nunjucks/plugin.js";

package/.server/server/plugins/nunjucks/plugin.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @type {ServerRegisterPluginObject<ServerViewsConfiguration>}
+ */
+export const plugin: ServerRegisterPluginObject<vision.ServerViewsConfiguration>;
+import vision from '@hapi/vision';
+import type { ServerRegisterPluginObject } from '@hapi/hapi';

package/.server/server/plugins/nunjucks/render.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Render Nunjucks macro
+ * @param {string} macroName
+ * @param {string} macroPath
+ * @param {RenderOptions & MacroOptions} [options]
+ */
+export function macro(macroName: string, macroPath: string, options?: RenderOptions & MacroOptions): string;
+/**
+ * Render Nunjucks code
+ * @param {string} viewString - Nunjucks string to render
+ * @param {RenderOptions} [options]
+ */
+export function string(viewString: string, options?: RenderOptions): string;
+/**
+ * Render Nunjucks view
+ * @param {string} viewPath
+ * @param {RenderOptions} [options]
+ */
+export function view(viewPath: string, options?: RenderOptions): string;
+import type { RenderOptions } from '~/src/server/plugins/nunjucks/types.js';
+import type { MacroOptions } from '~/src/server/plugins/nunjucks/types.js';

package/.server/server/plugins/nunjucks/types.d.ts

@@ -0,0 +1,56 @@
+export type MacroOptions = {
+    /**
+     * - Nunjucks call block content
+     */
+    callBlock?: string | undefined;
+    /**
+     * - Nunjucks macro params
+     */
+    params?: object | undefined;
+};
+export type RenderOptions = {
+    /**
+     * - Nunjucks render context
+     */
+    context?: object | undefined;
+};
+/**
+ * - Nunjucks view context
+ */
+export type ViewContext = {
+    /**
+     * - Base layout path
+     */
+    baseLayoutPath?: string | undefined;
+    /**
+     * - Cross-Site Request Forgery (CSRF) token
+     */
+    crumb?: string | undefined;
+    /**
+     * - Content Security Policy (CSP) nonce
+     */
+    cspNonce?: string | undefined;
+    /**
+     * - Current path
+     */
+    currentPath?: string | undefined;
+    /**
+     * - Preview mode
+     */
+    previewMode?: string | undefined;
+    /**
+     * - Form slug
+     */
+    slug?: string | undefined;
+    /**
+     * - the current form context
+     */
+    context?: FormContext | undefined;
+};
+export type NunjucksContext = {
+    /**
+     * - the current nunjucks view context
+     */
+    ctx: ViewContext;
+};
+import type { FormContext } from '~/src/server/plugins/engine/types.js';

package/.server/server/plugins/pulse.d.ts

@@ -0,0 +1,11 @@
+declare const _default: {
+    plugin: {
+        plugin: import("@hapi/hapi").Plugin<{
+            timeout: number;
+        }>;
+    };
+    options: {
+        timeout: number;
+    };
+};
+export default _default;

package/.server/server/plugins/session.d.ts

@@ -0,0 +1,24 @@
+import yar from '@hapi/yar';
+/**
+ * Yar is used for temporary session data but not form submissions, e.g. UI helpers, session flags.
+ */
+declare const _default: {
+    plugin: import("@hapi/hapi").Plugin<yar.YarOptions>;
+    options: {
+        maxCookieSize: number;
+        cache: {
+            cache: string;
+            segment: string;
+            expiresIn: number;
+        };
+        /**
+         * @todo storeBlank is current commented out as it's a minor efficiency gain but breaks the auth tests if enabled.
+         * this only seems to affect the auth code, which we might remove anyway so it's temporarily disabled.
+         */
+        cookieOptions: {
+            password: string;
+            isSecure: boolean;
+        };
+    };
+};
+export default _default;

package/.server/server/routes/index.d.ts

@@ -0,0 +1 @@
+export { default as publicRoutes } from '~/src/server/routes/public.js';

package/.server/server/routes/public.d.ts

@@ -0,0 +1,15 @@
+declare const _default: {
+    method: "GET";
+    path: string;
+    options: {
+        cache: {
+            otherwise: string;
+        };
+        handler: {
+            directory: {
+                path: string;
+            };
+        };
+    };
+}[];
+export default _default;

package/.server/server/routes/types.d.ts

@@ -0,0 +1,38 @@
+import { type ReqRefDefaults, type Request } from '@hapi/hapi';
+import { type FormPayload } from '~/src/server/plugins/engine/types.js';
+export interface FormQuery extends Partial<Record<string, string>> {
+    /**
+     * Allow preview URL direct access without relevant page checks
+     */
+    force?: string;
+    /**
+     * Redirect location after 'continue' form action
+     */
+    returnUrl?: string;
+}
+export interface FormParams extends Partial<Record<string, string>> {
+    path: string;
+    slug: string;
+    state?: FormStatus;
+}
+export interface FormRequestRefs extends Omit<ReqRefDefaults, 'Params' | 'Payload' | 'Query'> {
+    Params: FormParams;
+    Payload: object | undefined;
+    Query: FormQuery;
+}
+export interface FormRequestPayloadRefs extends FormRequestRefs {
+    Payload: FormPayload;
+}
+export type FormRequest = Request<FormRequestRefs>;
+export type FormRequestPayload = Request<FormRequestPayloadRefs>;
+export declare enum FormAction {
+    Continue = "continue",
+    Validate = "validate",
+    Delete = "delete",
+    AddAnother = "add-another",
+    Send = "send"
+}
+export declare enum FormStatus {
+    Draft = "draft",
+    Live = "live"
+}

package/.server/server/schemas/index.d.ts

@@ -0,0 +1,10 @@
+import Joi from 'joi';
+import { type FormParams } from '~/src/server/plugins/engine/types.js';
+import { FormAction, FormStatus } from '~/src/server/routes/types.js';
+export declare const stateSchema: Joi.StringSchema<FormStatus>;
+export declare const actionSchema: Joi.StringSchema<FormAction>;
+export declare const pathSchema: Joi.StringSchema<string>;
+export declare const itemIdSchema: Joi.StringSchema<string>;
+export declare const crumbSchema: Joi.StringSchema<string>;
+export declare const confirmSchema: Joi.BooleanSchema<boolean>;
+export declare const paramsSchema: Joi.ObjectSchema<FormParams>;

package/.server/server/secure-context.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Prepares the TLS secure context
+ * @param {Server} server
+ * @returns
+ */
+export function prepareSecureContext(server: Server): tls.SecureContext;
+/**
+ * @type {SecureContext}
+ */
+export let secureContext: tls.SecureContext;
+import type { Server } from '@hapi/hapi';
+import tls from 'node:tls';