meeting-schedules-parser

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

meeting-schedules-parser

★ 53 Open GitHub ↗

Parser for Meeting Workbook and Watchtower Study JWPUB and EPUB files

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Meeting Schedules Parser

[![CI](https://github.com/sws2apps/meeting-schedules-parser/actions/workflows/ci.yml/badge.svg)](https://github.com/sws2apps/meeting-schedules-parser/actions/workflows/ci.yml)
[![CD](https://github.com/sws2apps/meeting-schedules-parser/actions/workflows/deploy.yml/badge.svg)](https://github.com/sws2apps/meeting-schedules-parser/actions/workflows/deploy.yml)
[![semantic-release: angular](https://img.shields.io/badge/semantic--release-angular-e10079?logo=semantic-release)](https://github.com/semantic-release/semantic-release)
[![snyk](https://snyk.io/advisor/npm-package/meeting-schedules-parser/badge.svg)](https://snyk.io/advisor/npm-package/meeting-schedules-parser)
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=sws2apps_meeting-schedules-parser&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=sws2apps_meeting-schedules-parser)
[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=sws2apps_meeting-schedules-parser&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=sws2apps_meeting-schedules-parser)
[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=sws2apps_meeting-schedules-parser&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=sws2apps_meeting-schedules-parser)
[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=sws2apps_meeting-schedules-parser&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=sws2apps_meeting-schedules-parser)
[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=sws2apps_meeting-schedules-parser&metric=bugs)](https://sonarcloud.io/summary/new_code?id=sws2apps_meeting-schedules-parser)
[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=sws2apps_meeting-schedules-parser&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=sws2apps_meeting-schedules-parser)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/sws2apps/meeting-schedules-parser)

#### A parser utility to extract the needed meeting schedules from Meeting Workbook and Watchtower Study JWPUB and EPUB files.

## Install

```bash
npm i meeting-schedules-parser
```

### Browser environment (only)

If you will use this package in the browser, run the following command after installing:

```bash
npx meeting-schedules-parser
```

This is necessary to copy a web assembly file required in the browser.

Then adjust your bundler to ignore some Node built-in modules during build. For example, if using Vite, add the following:

```js
  build: {
    rollupOptions: {
      external: ['fs', 'path', 'crypto'],
    },
  },
```

## Usage

```js
// browser
import { loadPub } from 'meeting-schedules-parser';

// node esm
import { loadPub } from 'meeting-schedules-parser/dist/node/index.js';

// node commonjs
const { loadPub } = require('meeting-schedules-parser/dist/node/index.cjs');

// sample usage
const pub = await loadPub('/path/to/file.jwpub');

const pub = await loadPub({ url: fileUrl });
```

### loadPub(pubData)

function: asynchronous

#### pubData

type: `string` or `blob` or `url`

It can be the path to the JWPUB/EPUB file or JWPUB/EPUB file's blob or url to download the JWPUB/EPUB file.

## Return

By calling the `loadPub` function, it will return an array of objects with the following properties:

#### Meeting Workbook Data

| Name                     |       Type        | Description                                                                                                                     |
| ------------------------ | :---------------: | ------------------------------------------------------------------------------------------------------------------------------- |
| mwb_week_date            |      string       | Week date. For enhanced parsing, it is formatted as `yyyy/mm/dd`                                                                |
| mwb_week_date_locale\*   |      string       | Week date                                                                                                                       |
| mwb_weekly_bible_reading |      string       | Weekly Bible Reading                                                                                                            |
| mwb_song_first           |      integer      | First song                                                                                                                      |
| mwb_tgw_talk             |      string       | 10 min talk title of the Treasures from God’s Word                                                                              |
| mwb_tgw_talk_title\*     |      string       | 10 min talk full title of the Treasures from God’s Word                                                                         |
| mwb_tgw_gems_title       |      string       | Spiritual gems full title of the Treasures from God’s Word                                                                      |
| mwb_tgw_bread            |      string       | Bible Reading for student                                                                                                       |
| mwb_tgw_bread_title\*    |      string       | Bible Reading assignment full title for student                                                                                 |
| mwb_ayf_count            |      integer      | Number of parts in Apply Yourself to the Field Ministry                                                                         |
| mwb_ayf_part1            |      string       | Part 1 in Apply Yourself to the Field Ministry                                                                                  |
| mwb_ayf_part1_time\*     |      integer      | Timing of Part 1 in Apply Yourself to the Field Ministry                                                                        |
| mwb_ayf_part1_type\*     |      string       | Type of Part 1 in Apply Yourself to the Field Ministry                                                                          |
| mwb_ayf_part1_title\*    |      string       | Assignment full title of Part 1 in Apply Yourself to the Field Ministry                                                         |
| mwb_ayf_part2            |      string       | Part 2 in Apply Yourself to the Field Ministry. This property will not be available if `mwb_ayf_count` is 1                     |
| mwb_ayf_part2_time\*     |      integer      | Timing of Part 2 in Apply Yourself to the Field Ministry. This property will not be available if `mwb_ayf_count` is 1           |
| mwb_ayf_part2_type\*     |      string       | Type of Part 2 in Apply Yourself to the Field Ministry. This property will not be available if `mwb_ayf_count` is 1             |
| mwb_ayf_part2_title\*    |      string       | Assignment full title of Part 2 in Apply Yourself to the Field Ministry                                                         |
| mwb_ayf_part3            |      string       | Part 3 in Apply Yourself to the Field Ministry. This property will not be available if `mwb_ayf_count` is less than 3           |
| mwb_ayf_part3_time\*     |      integer      | Timing of Part 3 in Apply Yourself to the Field Ministry. This property will not be available if `mwb_ayf_count` is less than 3 |
| mwb_ayf_part3_type\*     |      string       | Type of Part 3 in Apply Yourself to the Field Ministry. This property will not be available if `mwb_ayf_count` is less than 3   |
| mwb_ayf_part3_title\*    |      string       | Assignment full title of Part 3 in Apply Yourself to the Field Ministry                                                         |
| mwb_ayf_part4            |      string       | Part 4 in Apply Yourself to the Field Ministry. This property will not be available if `mwb_ayf_count` is less than 4           |
| mwb_ayf_part4_time\*     |      integer      | Timing of Part 4 in Apply Yourself to the Field Ministry. This property will not be available if `mwb_ayf_count` is less than 4 |
| mwb_ayf_part4_type\*     |      string       | Type of Part 4 in Apply Yourself to the Field Ministry. This property will not be available if `mwb_ayf_count` is less than 4   |
| mwb_ayf_part4_title\*    |      string       | Assignment full title of Part 4 in Apply Yourself to the Field Ministry                                                         |
| mwb_song_middle          |      integer      | Middle song                                                                                                                     |
| mwb_lc_count             |      integer      | Number of parts in Living as Christians                                                                                         |
| mwb_lc_part1             |      string       | Part 1 in Living as Christians                                                                                                  |
| mwb_lc_part1_time\*      |      integer      | Timing of Part 1 in Living as Christians                                                                                        |
| mwb_lc_part1_content\*   |      string       | Content of Part 1 in Living as Christians                                                                                       |
| mwb_lc_part1_title\*     |      string       | Full title of Part 1 in Living as Christians                                                                                    |
| mwb_lc_part2             |      string       | Part 2 in Living as Christians. This property will not be available if `mwb_lc_count` is 1                                      |
| mwb_lc_part2_time\*      |      integer      | Timing of Part 2 in Living as Christians. This property will not be available if `mwb_lc_count` is 1                            |
| mwb_lc_part2_content\*   |      string       | Content of Part 2 in Living as Christians. This property will not be available if `mwb_lc_count` is 1                           |
| mwb_lc_part2_title\*     |      string       | Full title of Part 2 in Living as Christians                                                                                    |
| mwb_lc_cbs               |      string       | Congregation Bible Study source material                                                                                        |
| mwb_lc_cbs_title\*       |      string       | Congregation Bible Study assignment full title                                                                                  |
| mwb_song_conclude        | integer or string | Concluding song. When the song number is out of range, it will be the default text from the Meeting Workbook.                   |

#### Watchtower Study Data

| Name                    |  Type   | Description                                                      |
| ----------------------- | :-----: | ---------------------------------------------------------------- |
| w_study_date            | string  | Week date. For enhanced parsing, it is formatted as `yyyy/mm/dd` |
| w_study_date_locale\*   | string  | Week date                                                        |
| w_study_title           | string  | Watchtower Study Article Title                                   |
| w_study_opening_song    | integer | Opening Song for the Watchtower Study                            |
| w_study_concluding_song | integer | Concluding Song for the Watchtower Study                         |

\* These properties are only available when enhanced parsing is available for the language you parse.

Currently, we support enhanced parsing for **45+ languages**. For a complete and up-to-date list of supported languages, check:

- `src/config/enhanced_languages.ts` for the authoritative language codes
- `src/locales/` directory for locale-specific parsing rules and translations
- `src/node/utils.node.ts` and `src/browser/utils.browser.ts` for registered languages

Supported languages include (but not limited to):
Brazilian Portuguese, Bulgarian, Chinese (Simplified & Traditional), Dutch, English, Estonian, Finnish, French, German, Greek, Haitian Creole, Hebrew, Hindi, Hungarian, Iloko, Italian, Japanese, Kinyarwanda, Korean, Liberian English, Malagasy, Malay, Polish, Portuguese, Romanian, Russian, Slovenian, Spanish, Swahili, Swedish, Tagalog, Turkish, Ukrainian, Vietnamese, and more.

For the other languages, you may use your own method to convert these outputs according to your needs to get the needed informations. If you want to contribute and add or improve language support, please follow [this guide](./TRANSLATION.md).

For developer-focused locale onboarding and parser wiring, see [CONTRIBUTING.md](./CONTRIBUTING.md) under `Locale and Parsing Contributions`.

## Sample Output

Here are how the results of this module look like:

### With enhanced parsing

#### Meeting Workbook Data

```js
[
  {
    mwb_week_date: '2024/11/04',
    mwb_week_date_locale: 'NOVEMBER 4-10',
    mwb_weekly_bible_reading: 'PSALM 105',
    mwb_song_first: 3,
    mwb_tgw_talk: '“He Remembers His Covenant Forever”',
    mwb_tgw_talk_title: '1. “He Remembers His Covenant Forever”',
    mwb_tgw_gems_title: '2. Spiritual Gems',
    mwb_tgw_bread: 'Ps 105:24-45 (th study 5)',
    mwb_tgw_bread_title: '3. Bible Reading',
    mwb_ayf_count: 4,
    mwb_ayf_part1: 'HOUSE TO HOUSE. The householder is busy. (lmd lesson 2 point 5)',
    mwb_ayf_part1_time: 1,
    mwb_ayf_part1_type: 'Starting a Conversation',
    mwb_ayf_part1_title: '4. Starting a Conversation',
    mwb_ayf_part2: 'HOUSE TO HOUSE. End the conversation on a positive note when the person begins to argue. (lmd lesson 4 point 5)',
    mwb_ayf_part2_time: 2,
    mwb_ayf_part2_type: 'Starting a Conversation',
    mwb_ayf_part2_title: '5. Starting a Conversation',
    mwb_ayf_part3: 'HOUSE TO HOUSE. Offer a magazine on a topic that the person previously showed interest in. (lmd lesson 8 point 3)',
    mwb_ayf_part3_time: 4,
    mwb_ayf_part3_type: 'Following Up',
    mwb_ayf_part3_title: '6. Following Up',
    mwb_ayf_part4: 'INFORMAL WITNESSING. Tell the person about the JW Library® app, and help him download it. (lmd lesson 9 point 5)',
    mwb_ayf_part4_time: 4,
    mwb_ayf_part4_type: 'Following Up',
    mwb_ayf_part4_title: '7. Following Up',
    mwb_song_middle: 84,
    mwb_lc_count: 1,
    mwb_lc_part1: 'Expressions of Your Love',
    mwb_lc_part1_time: 15,
    mwb_lc_part1_title: '8. Expressions of Your Love',
    mwb_lc_part1_content: 'Discussion.',
    mwb_lc_cbs: 'bt chap. 17 ¶13-19',
    mwb_lc_cbs_title: '9. Congregation Bible Study',
    mwb_song_conclude: 97,
  },
	...
]
```

#### Watchtower Study Data

```js
[
  {
    w_study_date: '2025/01/06',
    w_study_date_locale: 'Study Article 44: January 6-12, 2025',
    w_study_title: 'How to Cope With Injustice',
    w_study_opening_song: 33,
    w_study_concluding_song: 38
  },
	...
]
```

### Without enhanced parsing

#### Meeting Workbook Data

```js
[
  {
    mwb_week_date: '4.-10. NOVEMBER',
    mwb_weekly_bible_reading: 'SALME 105',
    mwb_song_first: 3,
    mwb_tgw_talk: '1. “Han husker for evigt sin pagt” (10 min.)',
    mwb_tgw_gems_title: '2. Åndelige perler (10 min.)',
    mwb_tgw_bread: '3. Oplæsning fra Bibelen (4 min.) Sl 105:24-45 (th arbejdspunkt 5)',
    mwb_ayf_count: 4,
    mwb_ayf_part1: '4. Start en samtale (1 min.) FRA HUS TIL HUS. Den besøgte har travlt. (lmd lektion 2 punkt 5)',
    mwb_ayf_part2: '5. Start en samtale (2 min.) FRA HUS TIL HUS. Du afslutter samtalen på en venlig måde da den besøgte vil diskutere. (lmd lektion 4 punkt 5)',
    mwb_ayf_part3: '6. Følg op på interessen (4 min.) FRA HUS TIL HUS. Tilbyd et blad om noget som den besøgte tidligere har udtrykt interesse for. (lmd lektion 8 punkt 3)',
    mwb_ayf_part4: '7. Følg op på interessen (4 min.) UFORMEL FORKYNDELSE. Fortæl personen om JW Library®-appen, og hjælp ham eller hende med at downloade den. (lmd lektion 9 punkt 5)',
    mwb_song_middle: 84,
    mwb_lc_count: 1,
    mwb_lc_part1: '8. Hvordan vi kan vise vores kærlighed (15 min.) Drøftelse.',
    mwb_lc_cbs: '9. Menighedsbibelstudiet (30 min.) bt kap. 17 § 13-19',
    mwb_song_conclude: 97,
  },
	...
]
```

#### Watchtower Study Data

```js
[
  {
    w_study_date: 'Studieartikel 44, 6.-12. januar 2025',
    w_study_title: 'Hvordan du kan tackle uretfærdighed',
    w_study_opening_song: 33,
    w_study_concluding_song: 38
  },
	...
]
```

meeting-schedules-parser

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README