From fe35c72096a18ce49abfeea8ce1a920172cafa22 Mon Sep 17 00:00:00 2001 From: Bugs5382 Date: Sat, 29 Jun 2024 00:36:00 -0400 Subject: [PATCH] docs: typedoc update - @since is now not reporting any errors - @description changed for @remarks - updated dev depends --- .github/workflows/deploy-ci.yaml | 16 ++++++++-------- .github/workflows/pr-unit-tests.yml | 8 ++++---- package.json | 8 ++++---- src/builder/batch.ts | 15 +++++++-------- src/builder/fileBatch.ts | 11 +++++------ src/builder/message.ts | 7 +++---- src/builder/modules/emptyNode.ts | 1 - src/builder/modules/nodeBase.ts | 1 - src/builder/modules/segment.ts | 1 - src/client/client.ts | 2 +- src/client/connection.ts | 8 ++++---- src/client/module/inboundResponse.ts | 2 +- src/specification/2.1.ts | 8 ++++---- src/specification/2.2.ts | 8 ++++---- src/specification/2.3.1.ts | 8 ++++---- src/specification/2.3.ts | 8 ++++---- src/specification/2.4.ts | 8 ++++---- src/specification/2.5.1.ts | 8 ++++---- src/specification/2.5.ts | 8 ++++---- src/specification/2.6.ts | 8 ++++---- src/specification/2.7.1.ts | 8 ++++---- src/specification/2.7.ts | 8 ++++---- src/specification/2.8.ts | 8 ++++---- src/specification/specification.ts | 2 +- src/utils/enum.ts | 4 ++-- src/utils/normalizedBuilder.ts | 2 +- src/utils/normalizedClient.ts | 2 +- src/utils/parserPlan.ts | 2 +- src/utils/utils.ts | 10 +++++----- 29 files changed, 92 insertions(+), 98 deletions(-) diff --git a/.github/workflows/deploy-ci.yaml b/.github/workflows/deploy-ci.yaml index 7275dad..a3b0ae7 100644 --- a/.github/workflows/deploy-ci.yaml +++ b/.github/workflows/deploy-ci.yaml @@ -35,38 +35,38 @@ jobs: with: node-version: ${{ matrix.node-version }} - name: Install Dependencies - if: steps.filter.outputs.src == 'true' && steps.filter.outputs.test == 'true' + if: steps.filter.outputs.src == 'true' || steps.filter.outputs.test == 'true' run: npm install --ignore-scripts - name: Run Lint - if: steps.filter.outputs.src == 'true' && steps.filter.outputs.test == 'true' + if: steps.filter.outputs.src == 'true run: npm run lint - name: Run Unit Tests - if: steps.filter.outputs.src == 'true' && steps.filter.outputs.test == 'true' + if: steps.filter.outputs.test == 'true' run: npm run test Release: runs-on: ubuntu-latest needs: [ 'Test' ] steps: - uses: actions/checkout@v4 - if: ${{ needs.Test.outputs.src == 'true' && needs.Test.outputs.test == 'true' }} + if: ${{ needs.Test.outputs.src == 'true' }} with: persist-credentials: false - name: Use Node.js - if: ${{ needs.Test.outputs.src == 'true' && needs.Test.outputs.test == 'true' }} + if: ${{ needs.Test.outputs.src == 'true' }} uses: actions/setup-node@v4 with: node-version: 'lts/*' - name: NPM Install - if: ${{ needs.Test.outputs.src == 'true' && needs.Test.outputs.test == 'true' }} + if: ${{ needs.Test.outputs.src == 'true' }} run: npm install --ignore-scripts - name: Semantic Release (Dry Run) - if: ${{ needs.Test.outputs.src == 'true' && needs.Test.outputs.test == 'true' }} + if: ${{ needs.Test.outputs.src == 'true' }} run: npm run semantic-release:dry-run env: GITHUB_TOKEN: ${{ secrets.GH_TOKEN }} NPM_TOKEN: ${{ secrets.NPM_TOKEN }} - name: Semantic Release - if: ${{ needs.Test.outputs.src == 'true' && needs.Test.outputs.test == 'true' }} + if: ${{ needs.Test.outputs.src == 'true' }} run: npm run semantic-release env: GITHUB_TOKEN: ${{ secrets.GH_TOKEN }} diff --git a/.github/workflows/pr-unit-tests.yml b/.github/workflows/pr-unit-tests.yml index f58254b..2ead427 100644 --- a/.github/workflows/pr-unit-tests.yml +++ b/.github/workflows/pr-unit-tests.yml @@ -32,15 +32,15 @@ jobs: with: node-version: ${{ matrix.node-version }} - name: Install Dependencies - if: steps.filter.outputs.src == 'true' && steps.filter.outputs.test == 'true' + if: steps.filter.outputs.src == 'true' || steps.filter.outputs.test == 'true' run: npm install --ignore-scripts - name: Run Lint - if: steps.filter.outputs.src == 'true' && steps.filter.outputs.test == 'true' + if: steps.filter.outputs.src == 'true' run: npm run lint - name: Run Unit Tests - if: steps.filter.outputs.src == 'true' && steps.filter.outputs.test == 'true' + if: steps.filter.outputs.src == 'true' || steps.filter.outputs.test == 'true' run: npm run test - name: Check test results - if: steps.filter.outputs.src == 'true' && steps.filter.outputs.test == 'true' + if: steps.filter.outputs.src == 'true' || steps.filter.outputs.test == 'true' run: exit ${{ steps.Test.outputs.test_result }} id: check_test_result diff --git a/package.json b/package.json index 6834682..274dfbf 100644 --- a/package.json +++ b/package.json @@ -75,12 +75,12 @@ "@semantic-release/changelog": "^6.0.3", "@semantic-release/git": "^10.0.1", "@the-rabbit-hole/semantic-release-config": "^1.5.0", - "@types/node": "^20.14.8", + "@types/node": "^20.14.9", "@types/tcp-port-used": "^1.0.4", - "@typescript-eslint/parser": "^7.13.1", + "@typescript-eslint/parser": "^7.14.1", "@vitest/coverage-v8": "^1.6.0", "@vitest/ui": "^1.6.0", - "node-hl7-server": "^2.3.0", + "node-hl7-server": "^2.4.1", "npm-check-updates": "^16.14.20", "npm-package-json-lint": "^8.0.0", "portfinder": "^1.0.32", @@ -91,7 +91,7 @@ "ts-node": "^10.9.2", "ts-standard": "^12.0.2", "tsd": "^0.31.1", - "typedoc": "^0.26.2", + "typedoc": "^0.26.3", "typescript": "5.5.2", "vitest": "^1.6.0" }, diff --git a/src/builder/batch.ts b/src/builder/batch.ts index b2dc012..f12d70b 100644 --- a/src/builder/batch.ts +++ b/src/builder/batch.ts @@ -10,11 +10,10 @@ import { SegmentList } from './modules/segmentList.js' /** * Batch Class - * @description Creating a Batch (BHS) which could include hundreds of MSH segments for processing. + * @remarks Creating a Batch (BHS) which could include hundreds of MSH segments for processing. * Normally used in large data processing. * However, the server usually breaks down a batch MSH into single "elements" to process them and returns that the batch. * @since 1.0.0 - * @extends RootBase */ export class Batch extends RootBase { /** @internal **/ @@ -44,7 +43,7 @@ export class Batch extends RootBase { /** * Add a Message to the Batch - * @description This adds a Message (MSH) output into the batch. + * @remarks This adds a Message (MSH) output into the batch. * It also increases the count of the BTS segment as the batch final result * when in end tells the receiving end how many message (MSH) segments are included. * @since 1.0.0 @@ -63,7 +62,7 @@ export class Batch extends RootBase { /** * End Batch - * @description At the conclusion of building the batch, + * @remarks At the conclusion of building the batch, * (Usually {@link add} method will be before this) will add the Batch Trailing Segment (BTS) to the end. * If a message (MSH) is added after this, * that message (MSH) will get added to the first BHS found if there is more than one. @@ -95,7 +94,7 @@ export class Batch extends RootBase { /** * Get the First Segment - * @description Returns the first segment found in the Batch (BHS). + * @remarks Returns the first segment found in the Batch (BHS). * This is only used during the {@link add} method * in determining * if there is more than one Batch of MSH in a File Batch {@link FileBatch} @@ -110,7 +109,7 @@ export class Batch extends RootBase { /** * Get Messages within a submitted Batch - * @description This will parse the passed on "text" + * @remarks This will parse the passed on "text" * in the contractor options and get all the messages (MSH) segments within it and return an array of them. * @since 1.0.0 * @example @@ -166,7 +165,7 @@ export class Batch extends RootBase { /** * Start Batch - * @description This allows you to override the orginial contractor BHS fields that are required. + * @remarks This allows you to override the orginial contractor BHS fields that are required. * In this case, 'BHS.7' * (Date Field) is filled out with a 14-character date field with YYYYMMDDHHMMSS entered in by default. * @since 1.0.0 @@ -179,7 +178,7 @@ export class Batch extends RootBase { /** * Create File from a Batch - * @description Will procure a file of the saved MSH in the proper format + * @remarks Will procure a file of the saved MSH in the proper format * that includes a FHS and FTS segments with the possibility of more than one BHS segments inside with one or more MSH inside each BHS groups. * @since 1.0.0 * @param name File Name diff --git a/src/builder/fileBatch.ts b/src/builder/fileBatch.ts index 61b3c59..79a426f 100644 --- a/src/builder/fileBatch.ts +++ b/src/builder/fileBatch.ts @@ -13,13 +13,12 @@ import { SegmentList } from './modules/segmentList.js' /** * File Batch Class - * @description Create a File Batch (FHS) which will could include many BHS/BTS segments, + * @remarks Create a File Batch (FHS) which will could include many BHS/BTS segments, * which could include many Message (MSH) segments to output the contents into a file on the OS. * These files could then be used to send manually or read by another system to interpret the contents. * This class helps * in generating the particulars for that file generation to make sure that it follows the correct format. * @since 1.0.0 - * @extends RootBase */ export class FileBatch extends RootBase { /** @internal */ @@ -56,7 +55,7 @@ export class FileBatch extends RootBase { /** * AAdd a Message or a Batch to the File - * @description This adds a Message (MSH) output into the file batch. + * @remarks This adds a Message (MSH) output into the file batch. * If there is a Batch ("BHS") already part of this file, any new Message type will be added to the first found BHS regardless if the second Batch is added last. * @since 1.0.0 * @param message The {@link Message} or {@link Batch} to add into the batch. @@ -118,7 +117,7 @@ export class FileBatch extends RootBase { /** * End Batch - * @description At the conclusion of building the file batch, + * @remarks At the conclusion of building the file batch, * (Usually {@link add} method will be before this) will add the File Batch Trailing Segment (FTS) to the end. * If a message (MSH) is added after this, * that message (MSH) will get added to the first BHS found if there is one, otherwise it will just be added. @@ -132,7 +131,7 @@ export class FileBatch extends RootBase { /** * Get File name - * @description Get File name going to be created. + * @remarks Get File name going to be created. * @since 1.2.0 */ fileName (): string { @@ -158,7 +157,7 @@ export class FileBatch extends RootBase { /** * Get Messages within a submitted File Batch - * @description This will parse the passed on "text" + * @remarks This will parse the passed on "text" * in the contractor options and get all the messages (MSH) segments within it and return an array of them. * This will happen regardless of the depth of the segments. * @since 1.0.0 diff --git a/src/builder/message.ts b/src/builder/message.ts index 59087b2..af6b53c 100644 --- a/src/builder/message.ts +++ b/src/builder/message.ts @@ -11,7 +11,6 @@ import { HL7Node } from './interface/hL7Node.js' /** * Message Class * @since 1.0.0 - * @extends RootBase */ export class Message extends RootBase { /** @internal */ @@ -58,7 +57,7 @@ export class Message extends RootBase { /** * Add a new segment to a message. * @since 1.0.0 - * @description Creating a new segment adds an empty segment to the message. + * @remarks Creating a new segment adds an empty segment to the message. * It could be blank, or it could have values added into it. * @param path * @example @@ -109,7 +108,7 @@ export class Message extends RootBase { /** * Read a path of a message. - * @description Could return {@link SegmentList} + * @remarks Could return {@link SegmentList} * @since 1.0.0 * @param path */ @@ -173,7 +172,7 @@ export class Message extends RootBase { /** * Create File from a Message - * @description Will procure a file of the saved MSH in the proper format + * @remarks Will procure a file of the saved MSH in the proper format * that includes a FHS and FTS segments. * @since 1.0.0 * @param name File Name diff --git a/src/builder/modules/emptyNode.ts b/src/builder/modules/emptyNode.ts index 66164fb..27aedba 100644 --- a/src/builder/modules/emptyNode.ts +++ b/src/builder/modules/emptyNode.ts @@ -3,7 +3,6 @@ import { HL7Node } from '../interface/hL7Node.js' /** * Empty Node * @since 1.0.0 - * @extends HL7Node */ export class EmptyNode implements HL7Node { get name (): string { diff --git a/src/builder/modules/nodeBase.ts b/src/builder/modules/nodeBase.ts index 499cd8b..1b83941 100644 --- a/src/builder/modules/nodeBase.ts +++ b/src/builder/modules/nodeBase.ts @@ -10,7 +10,6 @@ import { Message } from '../message.js' /** * Node Base * @since 1.0.0 - * @extends HL7Node */ export class NodeBase extends EventEmitter implements HL7Node { protected parent: NodeBase | null diff --git a/src/builder/modules/segment.ts b/src/builder/modules/segment.ts index a636dd9..3f8fc7c 100644 --- a/src/builder/modules/segment.ts +++ b/src/builder/modules/segment.ts @@ -9,7 +9,6 @@ import { SubComponent } from './subComponent.js' /** * Segment * @since 1.0.0 - * @extends NodeBase */ export class Segment extends NodeBase { /** @internal */ diff --git a/src/client/client.ts b/src/client/client.ts index 2081c3f..69d34a2 100644 --- a/src/client/client.ts +++ b/src/client/client.ts @@ -9,7 +9,7 @@ import { Connection } from './connection.js' /** * Client Class - * @description The main class that starts a client connection to a valid HL7 TCP/MLLP specified server. + * @remarks The main class that starts a client connection to a valid HL7 TCP/MLLP specified server. * @since 1.0.0 */ export class Client extends EventEmitter { /** @internal */ diff --git a/src/client/connection.ts b/src/client/connection.ts index aa223dd..90431d8 100644 --- a/src/client/connection.ts +++ b/src/client/connection.ts @@ -35,7 +35,7 @@ export interface IConnection extends EventEmitter { /* eslint-enable */ /** Connection Class - * @description Create a connection customer that will listen to result send to the particular port. + * @remarks Create a connection customer that will listen to result send to the particular port. * @since 1.0.0 */ export class Connection extends EventEmitter implements IConnection { /** @internal */ @@ -113,7 +113,7 @@ export class Connection extends EventEmitter implements IConnection { } /** Close Client Listener Instance. - * @description Force close a connection. + * @remarks Force close a connection. * It will stop any re-connection timers. * If you want to restart, your app has to restart the connection. * @since 1.0.0 @@ -159,7 +159,7 @@ export class Connection extends EventEmitter implements IConnection { /** * Get Port - * @description Get the port that this connection will connect to. + * @remarks Get the port that this connection will connect to. * @since 2.0.0 */ getPort (): number { @@ -193,7 +193,7 @@ export class Connection extends EventEmitter implements IConnection { } /** Send a HL7 Message to the Listener - * @description This function sends a message/batch/file batch to the remote side. + * @remarks This function sends a message/batch/file batch to the remote side. * It has the ability, if set to auto-retry (defaulted to 1 re-connect before connection closes) * @since 1.0.0 * @param message The message we need to send to the port. diff --git a/src/client/module/inboundResponse.ts b/src/client/module/inboundResponse.ts index 41e0541..aa5c10a 100644 --- a/src/client/module/inboundResponse.ts +++ b/src/client/module/inboundResponse.ts @@ -10,7 +10,7 @@ export class InboundResponse { /** * Process the Inbound Response from the Server - * @description This takes the string of the response from the server and makes it a message. + * @remarks This takes the string of the response from the server and makes it a message. * A response from a broker SHOULD always be a properly formated Hl7 message, we hope. * @since 1.0.0 * @param data diff --git a/src/specification/2.1.ts b/src/specification/2.1.ts index 491e69b..ad9b5d2 100644 --- a/src/specification/2.1.ts +++ b/src/specification/2.1.ts @@ -4,7 +4,7 @@ import { HL7_SPEC_BASE } from './specification.js' /** * HL7 2.1 MSH Specification - * @description Only the required ones are listed below for typescript validation to pass. + * @remarks Only the required ones are listed below for typescript validation to pass. * @since 1.0.0 * @example * To make it easier on having to fill this out each time, you may do this in your code: @@ -28,12 +28,12 @@ export interface HL7_2_1_MSH { * @since 1.0.0 */ msh_9: string /** Message Control ID - * @description This ID is unique to the message being sent + * @remarks This ID is unique to the message being sent * so the client can track * to see if they get a response back from the server that this particular message was successful. * Max 20 characters. * @since 1.0.0 - * @default Random 20 Character String @see {@link randomString} if this is set to nothing or not included. */ + * @default Random 20 Character String {@link randomString} if this is set to nothing or not included. */ msh_10?: string /** Processing ID * @since 1.0.0 */ @@ -42,7 +42,7 @@ export interface HL7_2_1_MSH { /** * Hl7 Specification Version 2.1 - * @description Used to indicate that the message should follow 2.7 specification for retrieval or building a message. + * @remarks Used to indicate that the message should follow 2.7 specification for retrieval or building a message. * @since 1.0.0 */ export class HL7_2_1 extends HL7_SPEC_BASE { diff --git a/src/specification/2.2.ts b/src/specification/2.2.ts index 13941fd..eead191 100644 --- a/src/specification/2.2.ts +++ b/src/specification/2.2.ts @@ -4,7 +4,7 @@ import { HL7_SPEC_BASE } from './specification.js' /** * HL7 2.2 MSH Specification - * @description Only the required ones are listed below for typescript validation to pass. + * @remarks Only the required ones are listed below for typescript validation to pass. * @since 1.0.0 * @example * To make it easier on having to fill this out each time, you may do this in your code: @@ -32,12 +32,12 @@ export interface HL7_2_2_MSH { * @since 1.0.0 */ msh_9_2: string /** Message Control ID - * @description This ID is unique to the message being sent + * @remarks This ID is unique to the message being sent * so the client can track * to see if they get a response back from the server that this particular message was successful. * Max 20 characters. * @since 1.0.0 - * @default Random 20 Character String @see {@link randomString} if this is set to nothing or not included. */ + * @default Random 20 Character String {@link randomString} if this is set to nothing or not included. */ msh_10?: string /** Processing ID * @since 1.0.0 */ @@ -46,7 +46,7 @@ export interface HL7_2_2_MSH { /** * Hl7 Specification Version 2.2 - * @description Used to indicate that the message should follow 2.7 specification for retrieval or building a message. + * @remarks Used to indicate that the message should follow 2.7 specification for retrieval or building a message. * @since 1.0.0 */ export class HL7_2_2 extends HL7_SPEC_BASE { diff --git a/src/specification/2.3.1.ts b/src/specification/2.3.1.ts index 0316637..8cf9216 100644 --- a/src/specification/2.3.1.ts +++ b/src/specification/2.3.1.ts @@ -4,7 +4,7 @@ import { HL7_SPEC_BASE } from './specification.js' /** * HL7 2.3.1 MSH Specification - * @description Only the required ones are listed below for typescript validation to pass. + * @remarks Only the required ones are listed below for typescript validation to pass. * @since 1.0.0 * @example * To make it easier on having to fill this out each time, you may do this in your code: @@ -33,12 +33,12 @@ export interface HL7_2_3_1_MSH { * @since 1.0.0 */ msh_9_2: string /** Message Control ID - * @description This ID is unique to the message being sent + * @remarks This ID is unique to the message being sent * so the client can track * to see if they get a response back from the server that this particular message was successful. * Max 20 characters. * @since 1.0.0 - * @default Random 20 Character String @see {@link randomString} if this is set to nothing or not included. */ + * @default Random 20 Character String {@link randomString} if this is set to nothing or not included. */ msh_10?: string /** Processing ID * @since 1.0.0 */ @@ -50,7 +50,7 @@ export interface HL7_2_3_1_MSH { /** * Hl7 Specification Version 2.3.1 - * @description Used to indicate that the message should follow 2.7 specification for retrieval or building a message. + * @remarks Used to indicate that the message should follow 2.7 specification for retrieval or building a message. * @since 1.0.0 */ export class HL7_2_3_1 extends HL7_SPEC_BASE { diff --git a/src/specification/2.3.ts b/src/specification/2.3.ts index 1963cff..e0871b1 100644 --- a/src/specification/2.3.ts +++ b/src/specification/2.3.ts @@ -4,7 +4,7 @@ import { HL7_SPEC_BASE } from './specification.js' /** * HL7 2.3 MSH Specification - * @description Only the required ones are listed below for typescript validation to pass. + * @remarks Only the required ones are listed below for typescript validation to pass. * @since 1.0.0 * @example * To make it easier on having to fill this out each time, you may do this in your code: @@ -33,12 +33,12 @@ export interface HL7_2_3_MSH { * @since 1.0.0 */ msh_9_2: string /** Message Control ID - * @description This ID is unique to the message being sent + * @remarks This ID is unique to the message being sent * so the client can track * to see if they get a response back from the server that this particular message was successful. * Max 20 characters. * @since 1.0.0 - * @default Random 20 Character String @see {@link randomString} if this is set to nothing or not included. */ + * @default Random 20 Character String {@link randomString} if this is set to nothing or not included. */ msh_10?: string /** Processing ID * @since 1.0.0 */ @@ -50,7 +50,7 @@ export interface HL7_2_3_MSH { /** * Hl7 Specification Version 2.3 - * @description Used to indicate that the message should follow 2.7 specification for retrieval or building a message. + * @remarks Used to indicate that the message should follow 2.7 specification for retrieval or building a message. * @since 1.0.0 */ export class HL7_2_3 extends HL7_SPEC_BASE { diff --git a/src/specification/2.4.ts b/src/specification/2.4.ts index fd7d332..950fbf6 100644 --- a/src/specification/2.4.ts +++ b/src/specification/2.4.ts @@ -3,7 +3,7 @@ import { HL7_2_3_1 } from './2.3.1.js' /** * HL7 2.4 MSH Specification - * @description Only the required ones are listed below for typescript validation to pass. + * @remarks Only the required ones are listed below for typescript validation to pass. * @since 1.0.0 * @example * To make it easier on having to fill this out each time, you may do this in your code: @@ -36,12 +36,12 @@ export interface HL7_2_4_MSH { * @default If not specified, it will be the combo of 9.1 and 9.2 with an underscore. */ msh_9_3?: string /** Message Control ID - * @description This ID is unique to the message being sent + * @remarks This ID is unique to the message being sent * so the client can track * to see if they get a response back from the server that this particular message was successful. * Max 20 characters. * @since 1.0.0 - * @default Random 20 Character String @see {@link randomString} if this is set to nothing or not included. */ + * @default Random 20 Character String {@link randomString} if this is set to nothing or not included. */ msh_10?: string /** Processing ID * @since 1.0.0 */ @@ -53,7 +53,7 @@ export interface HL7_2_4_MSH { /** * Hl7 Specification Version 2.4 - * @description Used to indicate that the message should follow 2.7 specification for retrieval or building a message. + * @remarks Used to indicate that the message should follow 2.7 specification for retrieval or building a message. * @since 1.0.0 */ export class HL7_2_4 extends HL7_2_3_1 { diff --git a/src/specification/2.5.1.ts b/src/specification/2.5.1.ts index da16246..0d8c0d0 100644 --- a/src/specification/2.5.1.ts +++ b/src/specification/2.5.1.ts @@ -3,7 +3,7 @@ import { HL7_2_5 } from './2.5.js' /** * HL7 2.5.1 MSH Specification - * @description Only the required ones are listed below for typescript validation to pass. + * @remarks Only the required ones are listed below for typescript validation to pass. * @since 1.0.0 * @example * To make it easier on having to fill this out each time, you may do this in your code: @@ -36,12 +36,12 @@ export interface HL7_2_5_1_MSH { * @default If not specified, it will be the combo of 9.1 and 9.2 with an underscore. */ msh_9_3?: string /** Message Control ID - * @description This ID is unique to the message being sent + * @remarks This ID is unique to the message being sent * so the client can track * to see if they get a response back from the server that this particular message was successful. * Max 20 characters. * @since 1.0.0 - * @default Random 20 Character String @see {@link randomString} if this is set to nothing or not included. */ + * @default Random 20 Character String {@link randomString} if this is set to nothing or not included. */ msh_10?: string /** Processing ID * @since 1.0.0 */ @@ -53,7 +53,7 @@ export interface HL7_2_5_1_MSH { /** * Hl7 Specification Version 2.5.1 - * @description Used to indicate that the message should follow 2.7 specification for retrieval or building a message. + * @remarks Used to indicate that the message should follow 2.7 specification for retrieval or building a message. * @since 1.0.0 */ export class HL7_2_5_1 extends HL7_2_5 { diff --git a/src/specification/2.5.ts b/src/specification/2.5.ts index 46a1adf..44b87b9 100644 --- a/src/specification/2.5.ts +++ b/src/specification/2.5.ts @@ -3,7 +3,7 @@ import { HL7_2_4 } from './2.4.js' /** * HL7 2.5 MSH Specification - * @description Only the required ones are listed below for typescript validation to pass. + * @remarks Only the required ones are listed below for typescript validation to pass. * @since 1.0.0 * @example * To make it easier on having to fill this out each time, you may do this in your code: @@ -36,12 +36,12 @@ export interface HL7_2_5_MSH { * @default If not specified, it will be the combo of 9.1 and 9.2 with an underscore. */ msh_9_3?: string /** Message Control ID - * @description This ID is unique to the message being sent + * @remarks This ID is unique to the message being sent * so the client can track * to see if they get a response back from the server that this particular message was successful. * Max 20 characters. * @since 1.0.0 - * @default Random 20 Character String @see {@link randomString} if this is set to nothing or not included. */ + * @default Random 20 Character String {@link randomString} if this is set to nothing or not included. */ msh_10?: string /** Processing ID * @since 1.0.0 */ @@ -53,7 +53,7 @@ export interface HL7_2_5_MSH { /** * Hl7 Specification Version 2.5 - * @description Used to indicate that the message should follow 2.7 specification for retrieval or building a message. + * @remarks Used to indicate that the message should follow 2.7 specification for retrieval or building a message. * @since 1.0.0 */ export class HL7_2_5 extends HL7_2_4 { diff --git a/src/specification/2.6.ts b/src/specification/2.6.ts index e844b14..fb04afe 100644 --- a/src/specification/2.6.ts +++ b/src/specification/2.6.ts @@ -3,7 +3,7 @@ import { HL7_2_5_1 } from './2.5.1.js' /** * HL7 2.6 MSH Specification - * @description Only the required ones are listed below for typescript validation to pass. + * @remarks Only the required ones are listed below for typescript validation to pass. * @since 1.0.0 * @example * To make it easier on having to fill this out each time, you may do this in your code: @@ -36,12 +36,12 @@ export interface HL7_2_6_MSH { * @default If not specified, it will be the combo of 9.1 and 9.2 with an underscore. */ msh_9_3?: string /** Message Control ID - * @description This ID is unique to the message being sent + * @remarks This ID is unique to the message being sent * so the client can track * to see if they get a response back from the server that this particular message was successful. * Max 20 characters. * @since 1.0.0 - * @default Random 20 Character String @see {@link randomString} if this is set to nothing or not included. */ + * @default Random 20 Character String {@link randomString} if this is set to nothing or not included. */ msh_10?: string /** Processing ID * @since 1.0.0 */ @@ -53,7 +53,7 @@ export interface HL7_2_6_MSH { /** * Hl7 Specification Version 2.6 - * @description Used to indicate that the message should follow 2.7 specification for retrieval or building a message. + * @remarks Used to indicate that the message should follow 2.7 specification for retrieval or building a message. * @since 1.0.0 */ export class HL7_2_6 extends HL7_2_5_1 { diff --git a/src/specification/2.7.1.ts b/src/specification/2.7.1.ts index 04972d0..61c0c5f 100644 --- a/src/specification/2.7.1.ts +++ b/src/specification/2.7.1.ts @@ -3,7 +3,7 @@ import { HL7_2_7 } from './2.7.js' /** * HL7 2.7.1 MSH Specification - * @description Only the required ones are listed below for typescript validation to pass. + * @remarks Only the required ones are listed below for typescript validation to pass. * @since 1.0.0 * @example * To make it easier on having to fill this out each time, you may do this in your code: @@ -35,11 +35,11 @@ export interface HL7_2_7_1_MSH { * @default If not specified, it will be the combo of 9.1 and 9.2 with an underscore. */ msh_9_3?: string /** Message Control ID - * @description This ID is unique to the message being sent + * @remarks This ID is unique to the message being sent * so the client can track * to see if they get a response back from the server that this particular message was successful. * @since 1.0.0 - * @default Random 20 Character String @see {@link randomString} if this is set to nothing or not included. */ + * @default Random 20 Character String {@link randomString} if this is set to nothing or not included. */ msh_10?: string /** Processing ID * @since 1.0.0 */ @@ -51,7 +51,7 @@ export interface HL7_2_7_1_MSH { /** * Hl7 Specification Version 2.7.1 - * @description Used to indicate that the message should follow 2.7 specification for retrieval or building a message. + * @remarks Used to indicate that the message should follow 2.7 specification for retrieval or building a message. * @since 1.0.0 */ export class HL7_2_7_1 extends HL7_2_7 { diff --git a/src/specification/2.7.ts b/src/specification/2.7.ts index 331274a..d3efebb 100644 --- a/src/specification/2.7.ts +++ b/src/specification/2.7.ts @@ -3,7 +3,7 @@ import { HL7_2_6 } from './2.6.js' /** * HL7 2.7 MSH Specification - * @description Only the required ones are listed below for typescript validation to pass. + * @remarks Only the required ones are listed below for typescript validation to pass. * @since 1.0.0 * @example * To make it easier on having to fill this out each time, you may do this in your code: @@ -35,11 +35,11 @@ export interface HL7_2_7_MSH { * @default If not specified, it will be the combo of 9.1 and 9.2 with an underscore. */ msh_9_3?: string /** Message Control ID - * @description This ID is unique to the message being sent + * @remarks This ID is unique to the message being sent * so the client can track * to see if they get a response back from the server that this particular message was successful. * @since 1.0.0 - * @default Random 20 Character String @see {@link randomString} if this is set to nothing or not included. */ + * @default Random 20 Character String {@link randomString} if this is set to nothing or not included. */ msh_10?: string /** Processing ID * @since 1.0.0 */ @@ -51,7 +51,7 @@ export interface HL7_2_7_MSH { /** * Hl7 Specification Version 2.7 - * @description Used to indicate that the message should follow 2.7 specification for retrieval or building a message. + * @remarks Used to indicate that the message should follow 2.7 specification for retrieval or building a message. * @since 1.0.0 */ export class HL7_2_7 extends HL7_2_6 { diff --git a/src/specification/2.8.ts b/src/specification/2.8.ts index 103edca..1dd4d42 100644 --- a/src/specification/2.8.ts +++ b/src/specification/2.8.ts @@ -3,7 +3,7 @@ import { HL7_2_7_1 } from './2.7.1.js' /** * HL7 2.8 MSH Specification - * @description Only the required ones are listed below for typescript validation to pass. + * @remarks Only the required ones are listed below for typescript validation to pass. * @since 1.0.0 * @example * To make it easier on having to fill this out each time, you may do this in your code: @@ -35,11 +35,11 @@ export interface HL7_2_8_MSH { * @default If not specified, it will be the combo of 9.1 and 9.2 with an underscore. */ msh_9_3?: string /** Message Control ID - * @description This ID is unique to the message being sent + * @remarks This ID is unique to the message being sent * so the client can track * to see if they get a response back from the server that this particular message was successful. * @since 1.0.0 - * @default Random 20 Character String @see {@link randomString} if this is set to nothing or not included. */ + * @default Random 20 Character String {@link randomString} if this is set to nothing or not included. */ msh_10?: string /** Processing ID * @since 1.0.0 */ @@ -51,7 +51,7 @@ export interface HL7_2_8_MSH { /** * Hl7 Specification Version 2.8 - * @description Used to indicate that the message should follow 2.7 specification for retrieval or building a message. + * @remarks Used to indicate that the message should follow 2.7 specification for retrieval or building a message. * @since 1.0.0 */ export class HL7_2_8 extends HL7_2_7_1 { diff --git a/src/specification/specification.ts b/src/specification/specification.ts index 3b710b5..20fc5e6 100644 --- a/src/specification/specification.ts +++ b/src/specification/specification.ts @@ -51,7 +51,7 @@ export class HL7_SPEC_BASE implements HL7_SPEC { /** * Build MSH Header - * @description Add the required fields based on the spec chosen. + * @remarks Add the required fields based on the spec chosen. * @since 1.0.0 * @param _mshHeader * @param _massage diff --git a/src/utils/enum.ts b/src/utils/enum.ts index ef584d3..fb1e288 100644 --- a/src/utils/enum.ts +++ b/src/utils/enum.ts @@ -1,6 +1,6 @@ /** * Type of Segments Values - * @description Used during the class creation to give each type its own index value. + * @remarks Used during the class creation to give each type its own index value. * This is done during the constructor phase of the classes. * @since 1.0.0 */ @@ -21,7 +21,7 @@ export enum Delimiters { /** * State of the Connected to the Server - * @description These are the states that are used to track the connecting to the server side and also during the auto-reconnect phase. + * @remarks These are the states that are used to track the connecting to the server side and also during the auto-reconnect phase. * @since 1.0.0 */ export enum ReadyState { diff --git a/src/utils/normalizedBuilder.ts b/src/utils/normalizedBuilder.ts index df680f8..a69deb0 100644 --- a/src/utils/normalizedBuilder.ts +++ b/src/utils/normalizedBuilder.ts @@ -25,7 +25,7 @@ const DEFAULT_CLIENT_FILE_OPTS = { /** * Client Builder Options - * @description Used to specific default paramaters around building an HL7 message if that is + * @remarks Used to specific default paramaters around building an HL7 message if that is * so desired. * It also sets up checking of input values to make sure they match up to the proper * HL7 specification. diff --git a/src/utils/normalizedClient.ts b/src/utils/normalizedClient.ts index d0d6ae4..961375a 100644 --- a/src/utils/normalizedClient.ts +++ b/src/utils/normalizedClient.ts @@ -6,7 +6,7 @@ import { assertNumber, validIPv4, validIPv6 } from './utils.js' /** * Outbound Handler - * @description Used to receive a response from the server + * @remarks Used to receive a response from the server * @since 1.0.0 * @param res */ diff --git a/src/utils/parserPlan.ts b/src/utils/parserPlan.ts index d670a8d..63ebb55 100644 --- a/src/utils/parserPlan.ts +++ b/src/utils/parserPlan.ts @@ -1,7 +1,7 @@ /** * Parse Plan - * @description Used to figure out the current HL7 + * @remarks Used to figure out the current HL7 * message(s)/batch delimited used to encode this particular HL7 message * @since 1.0.0 */ diff --git a/src/utils/utils.ts b/src/utils/utils.ts index 207158c..92652be 100644 --- a/src/utils/utils.ts +++ b/src/utils/utils.ts @@ -17,7 +17,7 @@ export const assertNumber = (props: Record, name: string, min: n /** * Create a valid HL7 Date. - * @description Custom for this package and based of HL7 specification. + * @remarks Custom for this package and based of HL7 specification. * @since 1.0.0 * @param date * @param length @@ -107,7 +107,7 @@ export const isFile = (message: string): boolean => { /** * Is Number - * @description Custom for this package. + * @remarks Custom for this package. * @since 1.0.0 * @param value */ @@ -118,7 +118,7 @@ export const isHL7Number = (value: string | number): boolean => { /** * Is String - * @description Custom for this package. + * @remarks Custom for this package. * @since 1.0.0 * @param value */ @@ -181,7 +181,7 @@ export const randomString = (length = 20): string => { /** * Split the message. - * @description Split the message into its parts. + * @remarks Split the message into its parts. * @since 1.0.0 * @param data * @param segments @@ -202,7 +202,7 @@ export const split = (data: string, segments: string[] = []): string[] => { /** * Get Segment Indexes - * @description Helper for {@link split} + * @remarks Helper for {@link split} * @since 1.0.0 * @param names * @param data