@sefinek/google-tts-api 2.1.1 → 2.1.3

package/README.md

@@ -1,22 +1,21 @@
-# @sefinek/google-tts-api
-Google TTS (Text-To-Speech) for Node.js without any vulnerabilities.
+# 📢 @sefinek/google-tts-api
+Google TTS (Text-To-Speech) for [Node.js](https://nodejs.org) without any vulnerabilities.
 
-[![][npm-img]][npm-url]
+![@sefinek/google-tts-api.png](https://nodei.co/npm/@sefinek/google-tts-api.png)
 
-[![][dependency-img]][dependency-url]
-[![][dependency-dev-img]][dependency-dev-url]
-[![][install-size-img]][install-size-result]
+![@sefinek/google-tts-api.png](https://img.shields.io/npm/dt/@sefinek/google-tts-api?maxAge=3600)
+![@sefinek/google-tts-api.png](https://img.shields.io/github/last-commit/sefinek24/google-tts-api)
+![@sefinek/google-tts-api.png](https://img.shields.io/github/languages/code-size/sefinek24/google-tts-api)
 
-## Installation
+
+## 📥 Installation
 ```bash
 $ npm install --save google-tts-api
 $ npm install -D typescript @types/node # Only for TypeScript
 ```
 
-## Change Log
-[CHANGELOG.md](https://github.com/sefinek24/google-tts-api/blob/master/CHANGELOG.md)
 
-## Usage
+## 🤔 Usage
 | Method              | Options (all optional)                          | Return Type                                         | Handle Long Text |
 |---------------------|-------------------------------------------------|-----------------------------------------------------|:----------------:|
 | `getAudioUrl`       | `lang`, `slow`, `host`                          | `string`                                            |                  |
@@ -33,13 +32,14 @@ $ npm install -D typescript @types/node # Only for TypeScript
 | `timeout`    | `number`  | 10000 (ms)                   | (Only for `getAudioBase64` and `getAllAudioBase64`) Set timeout for the HTTP request.                                       |
 | `splitPunct` | `string`  |                              | (Only for `getAllAudioUrls` and `getAllAudioBase64`) Set the punctuation to split the long text to short text. (e.g. "，、。") |
 
-## Examples
+
+## 💻 Examples
 ### 1. `getAudioUrl(text, [option])`
 ```js
 import * as googleTTS from '@sefinek/google-tts-api'; // ES6 or TypeScript
 const googleTTS = require('@sefinek/google-tts-api'); // CommonJS
 
-// get audio URL
+// Get audio URL
 const url = googleTTS.getAudioUrl('Hello World', {
   lang: 'en',
   slow: false,
@@ -53,7 +53,7 @@ console.log(url); // https://translate.google.com/translate_tts?...
 import * as googleTTS from '@sefinek/google-tts-api'; // ES6 or TypeScript
 const googleTTS = require('@sefinek/google-tts-api'); // CommonJS
 
-// get base64 text
+// Get base64 text
 googleTTS
   .getAudioBase64('Hello World', {
     lang: 'en',
@@ -106,20 +106,8 @@ googleTTS
   .catch(console.error);
 ```
 
-[More Examples](https://github.com/sefinek24/google-tts-api/tree/master/example)
-
-## License
-MIT
-
-[npm-url]: https://nodei.co/npm/@sefinek/google-tts-api
-[npm-img]: https://nodei.co/npm/@sefinek/google-tts-api.png
-[install-size-img]: https://packagephobia.com/badge?p=@sefinek/google-tts-api
-[install-size-result]: https://packagephobia.com/result?p=@sefinek/google-tts-api
-[dependency-url]: https://david-dm.org/sefinek24/@sefinek/google-tts-api
-[dependency-img]: https://img.shields.io/david/sefinek24/@sefinek/google-tts-api.svg
-[dependency-dev-url]: https://david-dm.org/sefinek24/google-tts-api#info=devDependencies
-[dependency-dev-img]: https://img.shields.io/david/dev/sefinek24/google-tts-api.svg
-[gh-action-url]: https://github.com/sefinek24/google-tts-api/actions
-[gh-action-img]: https://github.com/sefinek24/google-tts-api/actions/workflows/build.yml/badge.svg
-[coverage-url]: https://coveralls.io/github/sefinek24/google-tts-api
-[coverage-img]: https://img.shields.io/coveralls/github/sefinek24/google-tts-api
+#### [More examples](https://github.com/sefinek24/google-tts-api/tree/master/example)
+
+
+## 📑 License
+MIT

package/dist/splitLongText.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/Trim
 var SPACE_REGEX = '\\s\\uFEFF\\xA0';
-// https://remarkablemark.org/blog/2019/09/28/javascript-remove-punctuation/
+// https://remarkablemark.org/blog/2019/09/28/javascript-remove-punctuation
 var DEFAULT_PUNCTUATION_REGEX = '!"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~';
 /**
  * split the long text to short texts

package/dist/splitLongText.js.map

@@ -1 +1 @@
-{"version":3,"file":"splitLongText.js","sourceRoot":"","sources":["../src/splitLongText.ts"],"names":[],"mappings":";;AAAA,+FAA+F;AAC/F,IAAM,WAAW,GAAG,iBAAiB,CAAC;AAEtC,4EAA4E;AAC5E,IAAM,yBAAyB,GAAG,oCAAoC,CAAC;AAOvE;;;;;;;;;GASG;AACH,IAAM,aAAa,GAAG,UAClB,IAAY,EACZ,EAAiD;QAAjD,qBAA+C,EAAE,KAAA,EAA/C,iBAAe,EAAf,SAAS,mBAAG,GAAG,KAAA,EAAE,kBAAe,EAAf,UAAU,mBAAG,EAAE,KAAA;IAEpC,IAAM,cAAc,GAAG,UAAC,CAAS,EAAE,CAAS;QAC1C,IAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,WAAW,GAAG,yBAAyB,GAAG,UAAU,GAAG,GAAG,CAAC,CAAC;QAC3F,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC;IAEF,IAAM,uBAAuB,GAAG,UAAC,CAAS,EAAE,IAAY,EAAE,KAAa;QACrE,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,IAAI,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY;IACzB,CAAC,CAAC;IAEF,IAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAM,SAAS,GAAG,UAAC,IAAY,EAAE,KAAa,EAAE,GAAW;QACzD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC;IAEF,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,SAAS,CAAC;QACR,sBAAsB;QACtB,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,IAAI,SAAS,EAAE,CAAC;YACrC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACxC,MAAM,CAAC,cAAc;QACvB,CAAC;QAED,+CAA+C;QAC/C,IAAI,GAAG,GAAG,KAAK,GAAG,SAAS,GAAG,CAAC,CAAC;QAChC,IAAI,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,cAAc,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;YAC/D,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAC5B,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QAED,2BAA2B;QAC3B,GAAG,GAAG,uBAAuB,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAChD,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,IAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;YACjD,MAAM,IAAI,KAAK,CACX,kDAAkD;gBAClD,YAAK,GAAG,SAAM;gBACd,mEAAmE,CACtE,CAAC;QACJ,CAAC;QAED,aAAa;QACb,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAC5B,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,kBAAe,aAAa,CAAC"}
+{"version":3,"file":"splitLongText.js","sourceRoot":"","sources":["../src/splitLongText.ts"],"names":[],"mappings":";;AAAA,+FAA+F;AAC/F,IAAM,WAAW,GAAG,iBAAiB,CAAC;AAEtC,2EAA2E;AAC3E,IAAM,yBAAyB,GAAG,oCAAoC,CAAC;AAOvE;;;;;;;;;GASG;AACH,IAAM,aAAa,GAAG,UAClB,IAAY,EACZ,EAAiD;QAAjD,qBAA+C,EAAE,KAAA,EAA/C,iBAAe,EAAf,SAAS,mBAAG,GAAG,KAAA,EAAE,kBAAe,EAAf,UAAU,mBAAG,EAAE,KAAA;IAEpC,IAAM,cAAc,GAAG,UAAC,CAAS,EAAE,CAAS;QAC1C,IAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,WAAW,GAAG,yBAAyB,GAAG,UAAU,GAAG,GAAG,CAAC,CAAC;QAC3F,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC;IAEF,IAAM,uBAAuB,GAAG,UAAC,CAAS,EAAE,IAAY,EAAE,KAAa;QACrE,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,IAAI,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY;IACzB,CAAC,CAAC;IAEF,IAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAM,SAAS,GAAG,UAAC,IAAY,EAAE,KAAa,EAAE,GAAW;QACzD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC;IAEF,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,SAAS,CAAC;QACR,sBAAsB;QACtB,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,IAAI,SAAS,EAAE,CAAC;YACrC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACxC,MAAM,CAAC,cAAc;QACvB,CAAC;QAED,+CAA+C;QAC/C,IAAI,GAAG,GAAG,KAAK,GAAG,SAAS,GAAG,CAAC,CAAC;QAChC,IAAI,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,cAAc,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;YAC/D,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAC5B,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QAED,2BAA2B;QAC3B,GAAG,GAAG,uBAAuB,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAChD,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,IAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;YACjD,MAAM,IAAI,KAAK,CACX,kDAAkD;gBAClD,YAAK,GAAG,SAAM;gBACd,mEAAmE,CACtE,CAAC;QACJ,CAAC;QAED,aAAa;QACb,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAC5B,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,kBAAe,aAAa,CAAC"}

package/example/british.js

@@ -0,0 +1,18 @@
+const fs = require('fs');
+const googleTTS = require('../dist/index');
+
+// 1. get audio URL
+const url = googleTTS.getAudioUrl('Hello World', { lang: 'en-GB' });
+console.log({ url }); // https://translate.google.com/translate_tts?...
+
+// 2. get base64 text
+googleTTS
+	.getAudioBase64('Hello World', { lang: 'en-GB' })
+	.then((base64) => {
+		console.log({ base64 });
+
+		// save the audio file
+		const buffer = Buffer.from(base64, 'base64');
+		fs.writeFileSync('hello-world-british.mp3', buffer, { encoding: 'base64' });
+	})
+	.catch(console.error);

package/example/chinese.js

@@ -0,0 +1,18 @@
+const fs = require('fs');
+const googleTTS = require('../dist/index');
+
+// 1. get audio URL
+const url = googleTTS.getAudioUrl('你好世界', { lang: 'zh-TW' });
+console.log({ url }); // https://translate.google.com/translate_tts?...
+
+// 2. get base64 text
+googleTTS
+	.getAudioBase64('你好世界', { lang: 'zh-TW' })
+	.then((base64) => {
+		console.log({ base64 });
+
+		// save the audio file
+		const buffer = Buffer.from(base64, 'base64');
+		fs.writeFileSync('hello-world-chinese.mp3', buffer, { encoding: 'base64' });
+	})
+	.catch(console.error);

package/example/download-by-audio-url.js

@@ -0,0 +1,54 @@
+const fs = require('fs');
+const path = require('path');
+const http = require('http');
+const https = require('https');
+const urlParse = require('url').parse;
+const googleTTS = require('../dist/index');
+
+function downloadFile(url, dest) {
+	return new Promise((resolve, reject) => {
+		const info = urlParse(url);
+		const httpClient = info.protocol === 'https:' ? https : http;
+		const options = {
+			host: info.host,
+			path: info.path,
+			headers: {
+				'user-agent': 'WHAT_EVER',
+			},
+		};
+
+		httpClient
+			.get(options, (res) => {
+				// check status code
+				if (res.statusCode !== 200) {
+					const msg = `request to ${url} failed, status code = ${res.statusCode} (${res.statusMessage})`;
+					reject(new Error(msg));
+					return;
+				}
+
+				const file = fs.createWriteStream(dest);
+				file.on('finish', function() {
+					// close() is async, call resolve after close completes.
+					file.close(resolve);
+				});
+				file.on('error', function(err) {
+					// Delete the file async. (But we don't check the result)
+					fs.unlink(dest);
+					reject(err);
+				});
+
+				res.pipe(file);
+			})
+			.on('error', reject)
+			.end();
+	});
+}
+
+// start
+const url = googleTTS.getAudioUrl('hello');
+console.log(url); // https://translate.google.com/translate_tts?...
+
+const dest = path.resolve(__dirname, 'hello.mp3'); // file destination
+console.log('Download to ' + dest + ' ...');
+downloadFile(url, dest);
+console.log('Download success');

package/example/english.js

@@ -0,0 +1,18 @@
+const fs = require('fs');
+const googleTTS = require('../dist/index');
+
+// 1. get audio URL
+const url = googleTTS.getAudioUrl('Hello World', { lang: 'en', slow: false });
+console.log({ url }); // https://translate.google.com/translate_tts?...
+
+// 2. get base64 text
+googleTTS
+	.getAudioBase64('Hello World', { lang: 'en', slow: false })
+	.then((base64) => {
+		console.log({ base64 });
+
+		// save the audio file
+		const buffer = Buffer.from(base64, 'base64');
+		fs.writeFileSync('hello-world-english.mp3', buffer, { encoding: 'base64' });
+	})
+	.catch(console.error);

package/example/long-chinese-text.js

@@ -0,0 +1,44 @@
+const fs = require('fs');
+const googleTTS = require('../dist/index');
+
+const article =
+  '如果想想生物在死之后被完全摧毁的种种方式，能够这样频繁出现化石是一件很令人惊讶的事。食腐动物和细菌的' +
+  '破坏、化学性腐烂、腐蚀以及其它地质因素都会非常不利于保存。不过，如果生物体碰巧具有矿化的骨骼并且死于' +
+  '可以迅速被沉积物掩埋的地方，摆脱被完全摧毁的几率便会大大增加。海底通常就具有上述的两方面条件，这里生' +
+  '活着很多带壳的无脊椎动物(没有脊椎的动物)，不断累积的似雨的沉积颗粒会把它们掩埋起来。虽然多数的化石是' +
+  '在海洋沉积岩中发现的，但是在溪流和湖泊留下的陆相沉积物中也发现过。有时，浸入焦油和流沙、陷入冰或熔岩' +
+  '流或被急速降落的火山灰吞噬的动植物得以保存下来。术语“化石”常常意味着石化，字面意思就是变成了石头。生' +
+  '物体死后，软组织一般会被食腐动物和细菌吃掉。可能会留下蜗牛或蛤蜊空壳，如果空壳足够坚固并且能抵御分解' +
+  '，就有可能在很长一段时间内基本上保持原样。事实上，我们现在所知的在沉积物中发现的海洋无脊椎动物保存良' +
+  '好的壳已超过了1亿年之久。不过，很多海洋生物的骨骼是由称为霰石的各式碳酸钙矿物质组成的。虽然霰石与我' +
+  '们更为熟悉的矿物方解石具有同样的组成，但是它的晶型不同，相对不稳定，最终会变成更稳定的方解石。很多其' +
+  '他过程也许会改变哈喇壳或蜗牛壳并且增加它被保存下来的几率。含有溶解的二氧化硅、碳酸钙或铁的水可能会在' +
+  '封闭的沉积物中流动，并沉积到诸如骨髓腔和骨头管道内，这些骨头管道曾经由血管和神经占据。这种情况下，骨' +
+  '和壳的原始组成没有改变，但是形成的化石更坚硬并且更持久。这种在孔隙中填充化学沉积物的过程就叫做“完全矿' +
+  '化”。石化还可能同时涉及死亡的动植物的原有物质与不同组成的矿物质的交换作用。该过程叫做“臵换作用”，因' +
+  '为溶液溶解了原始物质并将其臵换成为等体积的新物质。臵换是一个让人难以臵信的精确过程，贝壳装饰的细节、' +
+  '树木的年轮以及骨骼的精细结构都被精准地保存下来。另一种类型的石化，称为“碳化”，当软组织以碳薄膜的形式' +
+  '保存时会发生碳化。树叶和软体动物例如水母或蠕虫的组织可能会堆积起来，被掩埋并被压实，然后其中的挥发性' +
+  '成分会消失。碳通常以一种黑色轮廓的形式被保留下来。虽然拥有坚硬的部分的确会增加保存的可能性，但是具有' +
+  '软组织和器官的生物偶尔也会被保存下来。在针叶树以及某些其它的树种的凝固树脂中就发现了昆虫甚至是很小的' +
+  '无脊椎动物。对岩石薄片的X射线检查有时会发现可怕的触角轮廓、消化道和很多种海洋生物的视觉器官。冻土或石' +
+  '油渗漏时渗出的焦油中保存了包括皮肤、毛发和冰河时代猛犸象的内脏在内的软组织。如果生物体死于一个快速沉' +
+  '积和缺氧的环境，会有助于软组织残骸的保存。在这种条件下，细菌的破坏性影响会降低。德国始新世中期的麦塞' +
+  '尔页岩(来自4800万年前)就是在这种环境下积累起来的。该页岩在一个缺氧的湖泊里沉积，那里时有致命的气体' +
+  '冒出并杀死动物。动物的残骸在湖底聚集，然后被粘土和淤泥所覆盖。在保存完好的麦塞尔化石中有带闪亮外骨骼' +
+  '(硬质外部覆盖物)的昆虫，皮肤和血管完好无损的青蛙，甚至是毛皮和软组织都完整保存的小型哺乳动物。';
+
+const option = { lang: 'zh', splitPunct: '，、。' };
+
+// 1. all audio URLs
+const results = googleTTS.getAllAudioUrls(article, option);
+results.forEach((item, i) => {
+	console.log(`${i + 1}. ${item.shortText.length} characters`, item, '\n');
+});
+
+// 2. all audio base64 texts
+googleTTS.getAllAudioBase64(article, option).then((results) => {
+	results.forEach((item, i) => {
+		console.log(`${i + 1}. ${item.shortText.length} characters`, item, '\n');
+	});
+});

package/example/long-english-text.js

@@ -0,0 +1,53 @@
+const googleTTS = require('../dist/index');
+
+const article = `The Industrial Revolution had several roots, one of which was a commercial revolution that, beginning as far back as the sixteenth century, accompanied Europe’s expansion overseas.
+Both exports and imports showed spectacular growth, particularly in England and France.
+An increasingly larger portion of the stepped-up commercial activity was the result of trade with overseas colonies.
+Imports included a variety of new beverages, spices, and ship’s goods around the world and brought money flowing back.
+Europe’s economic institutions, particularly those in England, were strong, had wealth available for new investment, and seemed almost to be waiting for some technological breakthrough that would expand their profit-making potential even more.
+
+The breakthrough came in Great Britain, where several economic advantages created a climate especially favorable to the encouragement of new technology.
+One was its geographic location at the crossroads of international trade.
+Internally, Britain was endowed with easily navigable natural waterway, which helped its trade and communication with the world.
+Beginning in the 1770’s, it enjoyed a boom in canal building, which helped make its domestic market more accessible.
+Because water transportation was the cheapest means of carrying goods to market, canals reduced prices and thus increased consumer demand.
+Great Britain also had rich deposits of coal that fed the factories springing up in industrial and consumer goods.
+
+Another advantage was Britain’s large population of rural, agricultural wage earners,as well as cottage workers, who had the potential of being more mobile than peasants of some other countries.
+Eventually they found their way to the cities or mining communities and provided the human power upon which the Industrial Revolution was built.
+The British people were also consumers; the absence of internal tariffs, such as those that existed in France or Italy or between the German states, made Britain the largest free-trade area in Europe.
+Britain’s relatively stable government also helped create an atmosphere conducive to industrial progress.
+
+Great Britain’s better-developed banking and credit system also helped speed the industrial progress, as did the fact that it was the home of an impressive array of entrepreneurs and inventors.
+Among them were a large number of nonconformists whose religious principles encouraged thrift and industry rather than luxurious living and who tended to pour their profits back into their business, thus providing the basis for continued expansion.
+
+A precursor to the Industrial Revolution was a revolution in agricultural techniques.
+Ideas about agricultural reform developed first in Holland, where as early as the mid-seventeenth century, such modern methods as crop rotation, heavy fertilization, and diversification were all in use.
+Dutch peasant farmers were known throughout Europe for their agricultural innovations, but as British markets and opportunities grew, the English quickly learned from them.
+As early as the seventeenth century the Dutch were helping them drain marshes and fens where, with the help of advanced techniques, they grew new crops.
+By the mid-eighteenth century new agricultural methods as well as selective breeding of livestock had caught on throughout the country.
+
+aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
+
+Much of the increased production was consumed by Great Britain’s burgeoning population.
+At the same time, people were moving to the city, partly because of the enclosure movement; that is, the fencing of common fields and pastures in order to provide more compact, efficient privately held agricultural parcels that would produce more goods and greater profits.
+In the sixteenth century enclosures were usually used for creating sheep pastures, but by the eighteenth century new farming techniques made it advantageous for large landowners to seek enclosures in order to improve agricultural production.
+Between 1714 and 1820 over 6 million acres of English land were enclosed.
+As a result, many small, independent farmers were forced to sell out simply because they could not compete.
+Non-landholding peasants and cottage workers, who worked for wages and grazed cows or pigs on the village common, were also hurt when the common was no longer available.
+It was such people who began to flock to the cities seeking employment and who found work in the factories that would transform the nation and, the world.
+
+aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa`;
+
+// 1. all audio URLs
+const results = googleTTS.getAllAudioUrls(article);
+results.forEach((item, i) => {
+	console.log(`${i + 1}. ${item.shortText.length} characters`, item, '\n');
+});
+
+// 2. all audio base64 texts
+googleTTS.getAllAudioBase64(article).then((results) => {
+	results.forEach((item, i) => {
+		console.log(`${i + 1}. ${item.shortText.length} characters`, item, '\n');
+	});
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sefinek/google-tts-api",
-  "version": "2.1.1",
-  "description": "Google TTS (Text-To-Speech) for node.js",
+  "version": "2.1.3",
+  "description": "Google TTS (Text-To-Speech) for Node.js.",
   "keywords": [
     "tts",
     "google",
@@ -20,6 +20,16 @@
   "license": "MIT",
   "author": "zlargon",
   "main": "dist/index.js",
+  "directories": {
+    "example": "example",
+    "dist": "dist"
+  },
+  "files": [
+    "dist/",
+    "example/",
+    "LICENSE",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc -p .",
     "cover": "npm run build && jest --coverage",

package/.eslintrc.js

@@ -1,57 +0,0 @@
-module.exports = {
-	'env': {
-		'es6': true,
-		'node': true,
-		'browser': true,
-		'mongo': true,
-	},
-	'extends': ['eslint:recommended'],
-	'parserOptions': {
-		'ecmaVersion': 2023,
-	},
-	'rules': {
-		'arrow-spacing': ['warn', { before: true, after: true }],
-		// 'brace-style': ['error', 'stroustrup', { allowSingleLine: true }],
-		'comma-dangle': ['error', 'always-multiline'],
-		'comma-spacing': 'error',
-		'comma-style': 'error',
-		'curly': ['error', 'multi-line', 'consistent'],
-		'dot-location': ['error', 'property'],
-		'handle-callback-err': 'off',
-		'indent': ['warn', 'tab'],
-		'keyword-spacing': 'warn',
-		'max-nested-callbacks': ['error', { max: 4 }],
-		'max-statements-per-line': ['error', { max: 2 }],
-		'no-console': 'off',
-		'no-empty': 'warn',
-		'no-empty-function': 'error',
-		'no-floating-decimal': 'error',
-		// 'no-inline-comments': 'error',
-		'no-lonely-if': 'error',
-		'no-multi-spaces': 'warn',
-		'no-multiple-empty-lines': ['warn', { 'max': 4, 'maxEOF': 1, 'maxBOF': 0 }],
-		'no-shadow': ['error', { allow: ['err', 'resolve', 'reject'] }],
-		'no-trailing-spaces': ['warn'],
-		'no-var': 'error',
-		'object-curly-spacing': ['error', 'always'],
-		'prefer-const': 'error',
-		'quotes': ['warn', 'single'],
-		'semi': ['warn', 'always'],
-		'space-before-blocks': 'error',
-		'space-before-function-paren': ['error', {
-			anonymous: 'never',
-			named: 'never',
-			asyncArrow: 'always',
-		}],
-		'space-in-parens': 'error',
-		'space-infix-ops': 'error',
-		'space-unary-ops': 'error',
-		'spaced-comment': 'warn',
-		'yoda': 'error',
-		'no-use-before-define': ['error', { functions: false, classes: true }],
-		'no-unused-vars': 'warn',
-		'wrap-regex': 'error',
-		'sort-vars': 'warn',
-		'no-unreachable': 'warn',
-	},
-};

package/.github/workflows/build.yml

@@ -1,32 +0,0 @@
-# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
-# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
-
-name: google-tts
-on: [push, pull_request]
-jobs:
-  test:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-        node-version: [10.x, 12.x, 14.x, 15.x, 18.x, 20.x]
-    steps:
-      - uses: actions/checkout@v4
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-      - run: npm ci
-      - run: npm run build
-      - run: npm run cover
-      - uses: coverallsapp/github-action@v2
-        with:
-          github-token: ${{ secrets.github_token }}
-  upload-code-coverage-report:
-    needs: test
-    runs-on: ubuntu-latest
-    steps:
-      - uses: coverallsapp/github-action@v2
-        with:
-          github-token: ${{ secrets.github_token }}
-          parallel-finished: true

package/.idea/discord.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="DiscordProjectSettings">
-    <option name="show" value="PROJECT" />
-    <option name="description" value="" />
-  </component>
-</project>

package/.idea/google-tts-api.iml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="WEB_MODULE" version="4">
-  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$">
-      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
-      <excludeFolder url="file://$MODULE_DIR$/temp" />
-      <excludeFolder url="file://$MODULE_DIR$/tmp" />
-    </content>
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -1,6 +0,0 @@
-<component name="InspectionProjectProfileManager">
-  <profile version="1.0">
-    <option name="myName" value="Project Default" />
-    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
-  </profile>
-</component>

package/.idea/jsLibraryMappings.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="JavaScriptLibraryMappings">
-    <includedPredefinedLibrary name="Node.js Core" />
-  </component>
-</project>

package/.idea/jsLinters/eslint.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="EslintConfiguration">
-    <option name="fix-on-save" value="true" />
-  </component>
-</project>

package/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/google-tts-api.iml" filepath="$PROJECT_DIR$/.idea/google-tts-api.iml" />
-    </modules>
-  </component>
-</project>

package/.idea/vcs.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="" vcs="Git" />
-  </component>
-</project>

package/CHANGELOG.md

@@ -1,62 +0,0 @@
-## 2.0.2 (Mar 20, 2021)
-- Change default language to `en` ([#45](https://github.com/sefinek24/google-tts-api/issues/45))
-- Typescript: Remove type `Language` since API doesn't fully support language codes listed in the document
-
-## 2.0.1 (Jan 6, 2021)
-- Fix the vulnerabilities by upgrading the dependencies (#42, #44)
-
-## 2.0.0 (Dec 8, 2020)
-- Add new APIs (Please see the **Break Change** below)
-
-| Method              | Options (optional)                              | Return Type                                         | Handle Long Text |
-|---------------------|-------------------------------------------------|-----------------------------------------------------|:----------------:|
-| `getAudioUrl`       | `lang`, `slow`, `host`                          | `string`                                            |                  |
-| `getAudioBase64`    | `lang`, `slow`, `host`, `timeout`               | `Promise<string>`                                   |                  |
-| `getAllAudioUrls`   | `lang`, `slow`, `host`, `splitPunct`            | `{ shortText: string; url: string; }[]`             |        ✅         |
-| `getAllAudioBase64` | `lang`, `slow`, `host`, `timeout`, `splitPunct` | `Promise<{ shortText: string; base64: string; }[]>` |        ✅         |
-
-- Support new Google TTS API to get audio Base64 text ([#35](https://github.com/sefinek24/google-tts-api/issues/35))
-- Support long text input: `getAllAudioUrls` and `getAllAudioBase64` ([#30](https://github.com/sefinek24/google-tts-api/issues/30))
-- Support changing the `host` in option ([#16](https://github.com/sefinek24/google-tts-api/issues/16))
-- Support Typescript
-- Add dependency [axios](https://github.com/axios/axios)
-
-### **Break Change from 0.x.x to 2.x.x**
-`googleTTS()` is changed to `googleTTS.getAudioUrl()`.
-
-```js
-const googleTTS = require('@sefinek/google-tts-api');
-
-// Before version 0.0.6
-// Original googleTTS is a promise function
-const url = await googleTTS('Hello World', 'en', 1);
-
-// After version 2.0.0
-// Now googleTTS is an object with 4 new methods (getAudioUrl, getAudioBase64, getAllAudioUrls, getAllAudioBase64)
-// googleTTS.getAudioUrl is a non-promise function
-const url = googleTTS.getAudioUrl('Hello World', {
-  lang: 'en-US',
-  slow: false, // speed (number) is changed to slow (boolean)
-  host: 'https://translate.google.com', // allow to change the host
-});
-```
-
-## 0.0.6 (Dec 5, 2020)
-- `timeout` parameter is deprecated.
-- Remove dependency `isomorphic-fetch`.
-- Fix the change of Google Translate API ([@freddiefujiwara](https://github.com/freddiefujiwara) in [#37](https://github.com/sefinek24/google-tts-api/pull/37)). Read more in [#35](https://github.com/sefinek24/google-tts-api/issues/35)
-
-## 0.0.5 (Nov 8, 2020)
-- Upgrade the dependencies and fix the vulnerability. ([#32](https://github.com/sefinek24/google-tts-api/issues/32))
-- Add retry mechanism to prevent fetching token key failed too frequently. ([#33](https://github.com/sefinek24/google-tts-api/issues/33))
-
-## 0.0.4 (Nov 29, 2018)
-- Fix the change of Google Translate API ([@ncpierson](https://github.com/ncpierson) in [#19](https://github.com/sefinek24/google-tts-api/pull/19))
-
-## 0.0.3 (Sep 21, 2018)
-- Add package-lock.lock file
-- Fix the change of Google Translate API ([@ncpierson](https://github.com/ncpierson) in [#14](https://github.com/sefinek24/google-tts-api/pull/14))
-
-## 0.0.2 (Aug 25, 2017)
-- Add yarn.lock file
-- If length of input text is over than 200 characters, throw a `RangeError` with error message. ([#5](https://github.com/sefinek24/google-tts-api/issues/5))

package/tsconfig.json

@@ -1,73 +0,0 @@
-{
-  "compilerOptions": {
-    /* Visit https://aka.ms/tsconfig.json to read more about this file */
-
-    /* Basic Options */
-    // "incremental": true,                   /* Enable incremental compilation */
-    "target": "es5",                          /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019', 'ES2020', or 'ESNEXT'. */
-    "module": "commonjs",                     /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', 'es2020', or 'ESNext'. */
-    // "lib": [],                             /* Specify library files to be included in the compilation. */
-    // "allowJs": true,                       /* Allow javascript files to be compiled. */
-    // "checkJs": true,                       /* Report errors in .js files. */
-    // "jsx": "preserve",                     /* Specify JSX code generation: 'preserve', 'react-native', or 'react'. */
-    "declaration": true,                      /* Generates corresponding '.d.ts' file. */
-    "declarationMap": true,                   /* Generates a sourcemap for each corresponding '.d.ts' file. */
-    "sourceMap": true,                        /* Generates corresponding '.map' file. */
-    // "outFile": "./",                       /* Concatenate and emit output to single file. */
-    "outDir": "./dist",                       /* Redirect output structure to the directory. */
-    // "rootDir": "./",                       /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */
-    // "composite": true,                     /* Enable project compilation */
-    // "tsBuildInfoFile": "./",               /* Specify file to store incremental compilation information */
-    // "removeComments": true,                /* Do not emit comments to output. */
-    // "noEmit": true,                        /* Do not emit outputs. */
-    // "importHelpers": true,                 /* Import emit helpers from 'tslib'. */
-    // "downlevelIteration": true,            /* Provide full support for iterables in 'for-of', spread, and destructuring when targeting 'ES5' or 'ES3'. */
-    // "isolatedModules": true,               /* Transpile each file as a separate module (similar to 'ts.transpileModule'). */
-
-    /* Strict Type-Checking Options */
-    "strict": true,                           /* Enable all strict type-checking options. */
-    // "noImplicitAny": true,                 /* Raise error on expressions and declarations with an implied 'any' type. */
-    // "strictNullChecks": true,              /* Enable strict null checks. */
-    // "strictFunctionTypes": true,           /* Enable strict checking of function types. */
-    // "strictBindCallApply": true,           /* Enable strict 'bind', 'call', and 'apply' methods on functions. */
-    // "strictPropertyInitialization": true,  /* Enable strict checking of property initialization in classes. */
-    // "noImplicitThis": true,                /* Raise error on 'this' expressions with an implied 'any' type. */
-    // "alwaysStrict": true,                  /* Parse in strict mode and emit "use strict" for each source file. */
-
-    /* Additional Checks */
-    // "noUnusedLocals": true,                /* Report errors on unused locals. */
-    // "noUnusedParameters": true,            /* Report errors on unused parameters. */
-    // "noImplicitReturns": true,             /* Report error when not all code paths in function return a value. */
-    // "noFallthroughCasesInSwitch": true,    /* Report errors for fallthrough cases in switch statement. */
-    // "noUncheckedIndexedAccess": true,      /* Include 'undefined' in index signature results */
-
-    /* Module Resolution Options */
-    // "moduleResolution": "node",            /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */
-    // "baseUrl": "./",                       /* Base directory to resolve non-absolute module names. */
-    // "paths": {},                           /* A series of entries which re-map imports to lookup locations relative to the 'baseUrl'. */
-    // "rootDirs": [],                        /* List of root folders whose combined content represents the structure of the project at runtime. */
-    // "typeRoots": [],                       /* List of folders to include type definitions from. */
-    // "types": [],                           /* Type declaration files to be included in compilation. */
-    // "allowSyntheticDefaultImports": true,  /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */
-    "esModuleInterop": true,                  /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */
-    // "preserveSymlinks": true,              /* Do not resolve the real path of symlinks. */
-    // "allowUmdGlobalAccess": true,          /* Allow accessing UMD globals from modules. */
-
-    /* Source Map Options */
-    // "sourceRoot": "",                      /* Specify the location where debugger should locate TypeScript files instead of source locations. */
-    // "mapRoot": "",                         /* Specify the location where debugger should locate map files instead of generated locations. */
-    // "inlineSourceMap": true,               /* Emit a single file with source maps instead of having a separate file. */
-    // "inlineSources": true,                 /* Emit the source alongside the sourcemaps within a single file; requires '--inlineSourceMap' or '--sourceMap' to be set. */
-
-    /* Experimental Options */
-    // "experimentalDecorators": true,        /* Enables experimental support for ES7 decorators. */
-    // "emitDecoratorMetadata": true,         /* Enables experimental support for emitting type metadata for decorators. */
-
-    /* Advanced Options */
-    "skipLibCheck": true,                     /* Skip type checking of declaration files. */
-    "forceConsistentCasingInFileNames": true  /* Disallow inconsistently-cased references to the same file. */
-  },
-  "include": [
-    "src"
-  ]
-}