cifraclub-wrapper 1.0.1 → 1.0.2

package/README.md

@@ -0,0 +1,606 @@
+````md
+# cifraclub-wrapper
+
+Wrapper em TypeScript para buscar, listar, baixar e transpor cifras do Cifra Club.
+
+A biblioteca permite:
+
+- pesquisar músicas
+- listar músicas de um songbook
+- baixar cifras completas
+- transpor tons
+- ajustar capo
+- filtrar apenas letras, acordes ou remover tablaturas
+
+Ela expõe uma API simples para trabalhar com metadados e conteúdo processado das cifras.
+
+## Instalação
+
+```bash
+npm install cifraclub-wrapper
+````
+
+ou
+
+```bash
+yarn add cifraclub-wrapper
+```
+
+## Importação
+
+```ts
+import CifraClub from 'cifraclub-wrapper'
+```
+
+Também é possível importar os tipos e classes auxiliares:
+
+```ts
+import CifraClub, { Cifra, CifraList, CifraMeta } from 'cifraclub-wrapper'
+```
+
+## Visão geral
+
+A biblioteca possui três estruturas principais:
+
+### `CifraClub`
+
+Classe principal da API.
+
+Responsável por:
+
+* pesquisar músicas
+* listar músicas de um songbook
+* baixar várias cifras
+* carregar uma cifra individual
+
+### `Cifra`
+
+Representa uma cifra individual já carregada.
+
+Permite:
+
+* acessar metadados
+* acessar conteúdo estruturado
+* transpor a cifra
+* alterar capo
+* extrair apenas letras
+* extrair apenas acordes
+* remover tablaturas
+
+### `CifraList`
+
+Representa uma coleção de cifras.
+
+Permite aplicar filtros em lote, como:
+
+* `lyrics()`
+* `chords()`
+* `noTabs()`
+
+---
+
+## Exemplo rápido
+
+```ts
+import CifraClub from 'cifraclub-wrapper'
+
+async function main() {
+  const results = await CifraClub.search('quanta coisa tenho feito')
+
+  if (!results.length) return
+
+  const cifra = await CifraClub.get(results[0])
+
+  if (!cifra) return
+
+  console.log(cifra.metadata)
+  console.log(cifra.data)
+}
+
+main()
+```
+
+---
+
+## API
+
+## `CifraClub.search(search: string): Promise<CifraMeta[]>`
+
+Pesquisa músicas no Cifra Club a partir de um texto.
+
+### Exemplo
+
+```ts
+const results = await CifraClub.search('Aclame ao Senhor')
+
+console.log(results)
+```
+
+### Retorno
+
+Um array de objetos `CifraMeta` com dados básicos da música encontrada.
+
+### Observação
+
+O retorno da busca é inicial e pode não conter todos os campos completos até que a cifra seja carregada com `get()`.
+
+---
+
+## `CifraClub.list(id: string): Promise<CifraMeta[]>`
+
+Lista as músicas de um songbook pelo ID.
+
+### Exemplo
+
+```ts
+const musics = await CifraClub.list('123456')
+
+console.log(musics)
+```
+
+### Retorno
+
+Um array de `CifraMeta` com informações mais completas, incluindo:
+
+* tom original
+* capo
+* afinação
+* versão
+* id da música
+* autor
+
+---
+
+## `CifraClub.get(data: CifraMeta): Promise<Cifra | boolean>`
+
+Carrega uma cifra a partir de um objeto `CifraMeta`.
+
+### Exemplo
+
+```ts
+const results = await CifraClub.search('Porque Ele Vive')
+const cifra = await CifraClub.get(results[0])
+
+if (cifra) {
+  console.log(cifra.metadata)
+  console.log(cifra.data)
+}
+```
+
+### Retorno
+
+Retorna uma instância de `Cifra` em caso de sucesso, ou `false` em caso de erro.
+
+---
+
+## `CifraClub.downloadList(data?: CifraMeta[]): Promise<CifraList>`
+
+Baixa várias cifras e devolve uma coleção `CifraList`.
+
+### Exemplo
+
+```ts
+const musics = await CifraClub.list('123456')
+const cifras = await CifraClub.downloadList(musics)
+
+console.log(cifras.data)
+```
+
+---
+
+# Classe `Cifra`
+
+Representa uma cifra já carregada e processada.
+
+## Propriedades
+
+### `html_url: string`
+
+URL pública da cifra no site.
+
+### `metadata`
+
+Retorna os metadados da cifra.
+
+```ts
+console.log(cifra.metadata)
+```
+
+### `data`
+
+Retorna o conteúdo estruturado da cifra.
+
+```ts
+console.log(cifra.data)
+```
+
+Formato do conteúdo:
+
+```ts
+Array<{
+  type: string
+  text: string
+}>
+```
+
+Exemplo:
+
+```ts
+[
+  { type: 'indicator_chords', text: '[Intro] C  G  Am  F' },
+  { type: 'lyrics', text: 'Quanta coisa tenho feito...' },
+  { type: 'chords', text: 'C      G      Am      F' }
+]
+```
+
+---
+
+## Métodos
+
+## `await cifra.get()`
+
+Carrega ou recarrega a cifra.
+
+### Exemplo
+
+```ts
+await cifra.get()
+```
+
+---
+
+## `cifra.lyrics(): Cifra`
+
+Retorna uma nova instância contendo apenas linhas de letra.
+
+### Exemplo
+
+```ts
+const lyricsOnly = cifra.lyrics()
+
+console.log(lyricsOnly.data)
+```
+
+---
+
+## `cifra.chords(): Cifra`
+
+Retorna uma nova instância contendo apenas linhas de acordes e indicadores.
+
+### Exemplo
+
+```ts
+const chordsOnly = cifra.chords()
+
+console.log(chordsOnly.data)
+```
+
+---
+
+## `cifra.noTabs(): Cifra`
+
+Retorna uma nova instância sem linhas de tablatura.
+
+### Exemplo
+
+```ts
+const semTabs = cifra.noTabs()
+
+console.log(semTabs.data)
+```
+
+---
+
+## `await cifra.transpose(halfsteps = 0)`
+
+Transpõe a cifra em semitons.
+
+### Exemplo
+
+```ts
+await cifra.transpose(2)   // sobe 2 semitons
+await cifra.transpose(-1)  // desce 1 semitom
+```
+
+### Observação
+
+A transposição altera o conteúdo carregado da cifra.
+
+---
+
+## `await cifra.capo(capo = 0)`
+
+Altera o capo da música e recalcula o tom exibido nos metadados.
+
+### Exemplo
+
+```ts
+await cifra.capo(2)
+
+console.log(cifra.metadata.tone)
+```
+
+---
+
+# Classe `CifraList`
+
+Coleção de cifras.
+
+## Propriedade
+
+### `data: Cifra[]`
+
+Array com todas as cifras carregadas.
+
+---
+
+## Métodos
+
+## `push(...items)`
+
+Adiciona cifras à lista.
+
+```ts
+list.push(cifra1, cifra2)
+```
+
+## `lyrics(): CifraList`
+
+Aplica `lyrics()` em todas as cifras da lista.
+
+```ts
+const onlyLyrics = list.lyrics()
+```
+
+## `chords(): CifraList`
+
+Aplica `chords()` em todas as cifras da lista.
+
+```ts
+const onlyChords = list.chords()
+```
+
+## `noTabs(): CifraList`
+
+Remove tablaturas de todas as cifras da lista.
+
+```ts
+const noTabs = list.noTabs()
+```
+
+---
+
+# Tipo `CifraMeta`
+
+Estrutura de metadados usada pela biblioteca.
+
+```ts
+type CifraMeta = {
+  path: string
+  position: number
+  hash: URLSearchParams
+  name: string
+  author: string
+  tone_songbook: string
+  capo_songbook: number
+  tone: string
+  id: string
+  tuning: string
+  version: string
+  minor: boolean
+}
+```
+
+## Campos principais
+
+### `name`
+
+Nome da música.
+
+### `author`
+
+Nome do artista ou autor.
+
+### `tone_songbook`
+
+Tom original informado no songbook.
+
+### `capo_songbook`
+
+Capotraste original informado.
+
+### `tone`
+
+Tom calculado considerando capo.
+
+### `tuning`
+
+Afinação da música.
+
+### `version`
+
+Versão da cifra.
+
+### `minor`
+
+Indica se a música está em tonalidade menor.
+
+---
+
+# Tipos de linha no conteúdo
+
+O conteúdo processado da cifra é dividido em linhas com tipos.
+
+Os tipos mais comuns são:
+
+### `lyrics`
+
+Linha de letra.
+
+### `chords`
+
+Linha de acordes.
+
+### `tab`
+
+Linha de tablatura.
+
+### `indicator_lyrics`
+
+Linha de seção com letra, como `[Refrão]`.
+
+### `indicator_chords`
+
+Linha de seção com acordes, como `[Intro]`.
+
+### `empty`
+
+Linha vazia.
+
+---
+
+# Exemplos completos
+
+## Buscar e carregar a primeira música encontrada
+
+```ts
+import CifraClub from 'cifraclub-wrapper'
+
+async function main() {
+  const results = await CifraClub.search('Aclame ao Senhor')
+
+  if (!results.length) {
+    console.log('Nenhuma música encontrada')
+    return
+  }
+
+  const cifra = await CifraClub.get(results[0])
+
+  if (!cifra) {
+    console.log('Erro ao carregar cifra')
+    return
+  }
+
+  console.log('Metadados:', cifra.metadata)
+  console.log('Conteúdo:', cifra.data)
+}
+
+main()
+```
+
+## Baixar várias cifras de um songbook
+
+```ts
+import CifraClub from 'cifraclub-wrapper'
+
+async function main() {
+  const musics = await CifraClub.list('123456')
+  const list = await CifraClub.downloadList(musics)
+
+  console.log(list.data.length)
+}
+
+main()
+```
+
+## Trabalhar apenas com letras
+
+```ts
+const cifra = await CifraClub.get(meta)
+
+if (cifra) {
+  const onlyLyrics = cifra.lyrics()
+  console.log(onlyLyrics.data)
+}
+```
+
+## Trabalhar apenas com acordes
+
+```ts
+const cifra = await CifraClub.get(meta)
+
+if (cifra) {
+  const onlyChords = cifra.chords()
+  console.log(onlyChords.data)
+}
+```
+
+## Remover tablaturas
+
+```ts
+const cifra = await CifraClub.get(meta)
+
+if (cifra) {
+  const clean = cifra.noTabs()
+  console.log(clean.data)
+}
+```
+
+## Transpor música
+
+```ts
+const cifra = await CifraClub.get(meta)
+
+if (cifra) {
+  await cifra.transpose(1)
+  console.log(cifra.data)
+}
+```
+
+## Ajustar capo
+
+```ts
+const cifra = await CifraClub.get(meta)
+
+if (cifra) {
+  await cifra.capo(3)
+  console.log(cifra.metadata.tone)
+}
+```
+
+---
+
+# Observações
+
+Esta biblioteca depende da estrutura atual das respostas e páginas do Cifra Club. Mudanças no HTML ou nos endpoints utilizados podem impactar o funcionamento.
+
+As operações de download em lote incluem pequeno intervalo entre requisições para reduzir a agressividade das chamadas.
+
+---
+
+# Compatibilidade
+
+Compatível com ambientes Node.js que suportem:
+
+* `URLSearchParams`
+* `async/await`
+
+---
+
+# Licença
+
+MIT
+
+```
+MIT License
+
+Copyright (c) 2026 Sebastião Jonas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/dist/index.d.ts

@@ -1,15 +1,14 @@
 declare class Cifra {
-    id: string;
-    name: string;
-    author: string;
-    transpose: number;
-    meta: CifraMeta;
-    content: Array<{
-        type: string;
-        text: string;
-    }>;
+    private halfsteps;
+    private meta;
+    private content;
     readonly html_url: string;
     private readonly content_url;
+    get metadata(): CifraMeta;
+    get data(): {
+        type: string;
+        text: string;
+    }[];
     constructor(data: CifraMeta);
     lyrics(): Cifra;
     noTabs(): Cifra;
@@ -17,6 +16,9 @@ declare class Cifra {
     private formatContent;
     get(): Promise<void>;
     private fetch;
+    private calculateCapo;
+    transpose(halfsteps?: number): Promise<void>;
+    capo(capo?: number): Promise<void>;
     private getContent;
 }
 declare class CifraList {

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';Object.defineProperty(exports,'__esModule',{value:true});var u=require('axios');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var u__default=/*#__PURE__*/_interopDefault(u);var C=(a=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(a,{get:(t,r)=>(typeof require<"u"?require:t)[r]}):a)(function(a){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+a+'" is not supported')});var $=C("cheerio"),c=class{$;constructor(t){this.$=$.load(t,{decodeEntities:false});}find(t){return this.$(t)}setText(t,r){return this.$(t).text(r),this}setHtml(t,r){return this.$(t).html(r),this}addClass(t,r){return this.$(t).addClass(r),this}setAttr(t,r,s){return this.$(t).attr(r,s),this}remove(t){return this.$(t).remove(),this}each(t,r){return this.$(t).each((s,e)=>r(this.$(e),s)),this}extractText(t){return this.$(t).text().trim()}extractList(t){return this.$(t).map((r,s)=>this.$(s).text().trim()).get()}html(){return this.$.html()}};var w=a=>`https://solr.sscdn.co/cc/h2/?q=${encodeURIComponent(a)}&callback`,f={accept:"*/*","accept-language":"pt-BR,pt;q=0.9",origin:"https://www.cifraclub.com.br",priority:"u=1, i",referer:"https://www.cifraclub.com.br/","sec-ch-ua":'"Chromium";v="142", "Google Chrome";v="142", "Not_A Brand";v="99"',"sec-ch-ua-mobile":"?0","sec-ch-ua-platform":'"Windows"',"sec-fetch-dest":"empty","sec-fetch-mode":"cors","sec-fetch-site":"same-site","user-agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36"},d="https://api.cifraclub.com.br/v3",_="https://www.cifraclub.com.br",b={start:/#t\d+#/g,end:/#\/t\d+#/g};function A(a,t,r=false,s=12){if(!r)return (t-a+s)%s;let e=(t-a)%s;return e>s/2&&(e-=s),e<-s/2&&(e+=s),e}var x=(a=0,t=false,r=false)=>`${["A",t?"A#":"Bb","B","C",t?"C#":"Db","D",t?"D#":"Eb","E","F",t?"F#":"Gb","G",t?"G#":"Ab"][a]}${r?"m":""}`,g=(a,t=false)=>{let r=["A",["Bb","A#"],["B","Cb"],["C","B#"],["Db","C#"],"D",["D#","Eb"],["E","Fb"],["F","E#"],["F#","Gb"],"G",["Ab","G#"]],s=false;return r.forEach((e,n)=>{s!==false&&typeof e=="string"||(typeof e=="string"&&a.startsWith(e)&&(s=t?new RegExp(e,"g"):n),Array.isArray(e)&&e.forEach(i=>{a.startsWith(i)&&(s=t?new RegExp(e.join("|"),"g"):n);}));}),s};function E(a){return new Promise(t=>setTimeout(t,a))}var v=/\b[A-G](?:#|b)?(?:maj|min|m|dim|aug|sus|add)?\d*(?:\([^)]+\))?(?:\/[A-G](?:#|b)?)?\b/g,p=class{id="";name="";author="";transpose=0;meta;content=[];html_url;content_url="";constructor(t){this.html_url=`${_}${t.path}`,this.content_url=`${d}/song/${t.id}/${t.hash.get("instrument")}/${t.version}/transpose`,this.meta=t;}lyrics(){return {...this,content:this.content.filter(t=>t.type.includes("lyrics"))}}noTabs(){return {...this,content:this.content.filter(t=>t.type!=="tab")}}chords(){return {...this,content:this.content.filter(t=>t.type.includes("chords")||t.type.includes("indicator_"))}}formatContent(t){this.content=t.split(`
-`).map(r=>{let s=r.match(/<\/?b>/gi),n=r.includes("|")&&r.includes("--")&&/A|B|C|D|E|F|G/i.test(r)?"tab":s?"chords":"lyrics";return r=r.replace(b.start,"").replace(b.end,""),r.includes("[")&&r.includes("]")&&(n=`indicator_${n}`),r.trim().length==0&&(n="empty"),{type:n,text:r.trimEnd().replace(/<\/?b>/gi,"")}}).filter((r,s,e)=>{if(s===0)return  true;let n=e[s-1].type=="empty";return !(r.type=="empty"&&n)});}async get(){await this.fetch();}async fetch(){let t=await u__default.default.get(this.html_url,{headers:f}),r=new c(t.data),[s,e]=r.find("#cifra_tom").text().match(v),n=g(e||s),i=r.find("#cifra_capo").text();if(!this.meta.capo_songbook&&i){let[y]=i.match(/\d+/g);this.meta.capo_songbook=parseInt(y);}let o=g(this.meta.tone_songbook);this.transpose=A(o,n,true);let m=o+this.meta.capo_songbook;m>=12&&(m-=12),this.meta.tone=x(m,true,this.meta.minor),await this.getContent();}async getContent(){let t=await u__default.default.get(`${this.content_url}?halfSteps=${this.transpose}&newFormat=false`,{headers:f});this.formatContent(t.data?.content||"");}},l=class a{data;constructor(t=[]){this.data=t;}push(...t){this.data.push(...t);}lyrics(){return new a(this.data.map(t=>t.lyrics()))}noTabs(){return new a(this.data.map(t=>t.noTabs()))}chords(){return new a(this.data.map(t=>t.chords()))}},h=class a{static async search(t){let r=w(t);try{let n=(await u__default.default.get(r)).data.trim().slice(1,-1);return JSON.parse(n).response.docs.map(o=>({path:`${o.d}/${o.u}`,hash:new URLSearchParams(""),name:o.m,author:o.a,position:0}))}catch{return []}}static async list(t){try{return (await u__default.default.get(`${d}/songbook/${t}`,{headers:f})).data?.songs?.map((s,e)=>{let[,n]=s.siteUrl.split("#"),i=s.apiUrl.split("version/")[1];return {position:e,path:`${s.apiUrl}${i?`/${i}.html`:""}`,hash:new URLSearchParams(n||""),name:s.name,author:s.artist.name,id:s.songId,tone_songbook:s.stdTone,tuning:s.tuning,version:i||"principal",capo_songbook:s.capo||0,minor:s.minor}})}catch(r){console.error(r);}return []}static async downloadList(t=[]){let r=new l;try{for(let s of t){console.log(`${s.name} - ${s.author} (${s.tone_songbook})`);let e=await a.get(s);e instanceof p&&r.push(e),await E(100);}}catch(s){console.error(s);}return r}static async get(t){try{let r=new p(t);return await r.get(),r}catch(r){console.log(r);}return  false}};var T=h;exports.Cifra=p;exports.CifraList=l;exports.default=T;
+'use strict';Object.defineProperty(exports,'__esModule',{value:true});var l=require('axios');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var l__default=/*#__PURE__*/_interopDefault(l);var y=(a=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(a,{get:(t,r)=>(typeof require<"u"?require:t)[r]}):a)(function(a){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+a+'" is not supported')});var C=y("cheerio"),c=class{$;constructor(t){this.$=C.load(t,{decodeEntities:false});}find(t){return this.$(t)}setText(t,r){return this.$(t).text(r),this}setHtml(t,r){return this.$(t).html(r),this}addClass(t,r){return this.$(t).addClass(r),this}setAttr(t,r,e){return this.$(t).attr(r,e),this}remove(t){return this.$(t).remove(),this}each(t,r){return this.$(t).each((e,s)=>r(this.$(s),e)),this}extractText(t){return this.$(t).text().trim()}extractList(t){return this.$(t).map((r,e)=>this.$(e).text().trim()).get()}html(){return this.$.html()}};var _=a=>`https://solr.sscdn.co/cc/h2/?q=${encodeURIComponent(a)}&callback`,f={accept:"*/*","accept-language":"pt-BR,pt;q=0.9",origin:"https://www.cifraclub.com.br",priority:"u=1, i",referer:"https://www.cifraclub.com.br/","sec-ch-ua":'"Chromium";v="142", "Google Chrome";v="142", "Not_A Brand";v="99"',"sec-ch-ua-mobile":"?0","sec-ch-ua-platform":'"Windows"',"sec-fetch-dest":"empty","sec-fetch-mode":"cors","sec-fetch-site":"same-site","user-agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36"},b="https://api.cifraclub.com.br/v3",$="https://www.cifraclub.com.br",g={start:/#t\d+#/g,end:/#\/t\d+#/g};function w(a,t,r=false,e=12){if(!r)return (t-a+e)%e;let s=(t-a)%e;return s>e/2&&(s-=e),s<-e/2&&(s+=e),s}var A=(a=0,t=false,r=false)=>`${["A",t?"A#":"Bb","B","C",t?"C#":"Db","D",t?"D#":"Eb","E","F",t?"F#":"Gb","G",t?"G#":"Ab"][a]}${r?"m":""}`,m=(a,t=false)=>{let r=["A",["Bb","A#"],["B","Cb"],["C","B#"],["Db","C#"],"D",["D#","Eb"],["E","Fb"],["F","E#"],["F#","Gb"],"G",["Ab","G#"]],e=false;return r.forEach((s,n)=>{e!==false&&typeof s=="string"||(typeof s=="string"&&a.startsWith(s)&&(e=t?new RegExp(s,"g"):n),Array.isArray(s)&&s.forEach(i=>{a.startsWith(i)&&(e=t?new RegExp(s.join("|"),"g"):n);}));}),e};function x(a){return new Promise(t=>setTimeout(t,a))}var E=/\b[A-G](?:#|b)?(?:maj|min|m|dim|aug|sus|add)?\d*(?:\([^)]+\))?(?:\/[A-G](?:#|b)?)?\b/g,h=class{halfsteps=0;meta;content=[];html_url;content_url="";get metadata(){return this.meta}get data(){return this.content}constructor(t){this.html_url=`${$}${t.path}`,this.content_url=`${b}/song/${t.id}/${t.hash.get("instrument")}/${t.version}/transpose`,this.meta=t;}lyrics(){return {...this,content:this.content.filter(t=>t.type.includes("lyrics"))}}noTabs(){return {...this,content:this.content.filter(t=>t.type!=="tab")}}chords(){return {...this,content:this.content.filter(t=>t.type.includes("chords")||t.type.includes("indicator_"))}}formatContent(t){this.content=t.split(`
+`).map(r=>{let e=r.match(/<\/?b>/gi),n=r.includes("|")&&r.includes("--")&&/A|B|C|D|E|F|G/i.test(r)?"tab":e?"chords":"lyrics";return r=r.replace(g.start,"").replace(g.end,""),r.includes("[")&&r.includes("]")&&(n=`indicator_${n}`),r.trim().length==0&&(n="empty"),{type:n,text:r.trimEnd().replace(/<\/?b>/gi,"")}}).filter((r,e,s)=>{if(e===0)return  true;let n=s[e-1].type=="empty";return !(r.type=="empty"&&n)});}async get(){await this.fetch();}async fetch(){let t=await l__default.default.get(this.html_url,{headers:f}),r=new c(t.data),[e,s]=r.find("#cifra_tom").text().match(E),n=m(s||e),i=r.find("#cifra_capo").text();if(!this.meta.capo_songbook&&i){let[d]=i.match(/\d+/g);this.meta.capo_songbook=parseInt(d);}let o=m(this.meta.tone_songbook);this.halfsteps=w(o,n,true),this.calculateCapo(),await this.getContent();}calculateCapo(){let r=m(this.meta.tone_songbook)+this.meta.capo_songbook;r>=12&&(r-=12),this.meta.tone=A(r,true,this.meta.minor);}async transpose(t=0){this.halfsteps+=t,await this.getContent();}async capo(t=0){this.meta.capo_songbook=t,this.calculateCapo();}async getContent(){let t=await l__default.default.get(`${this.content_url}?halfSteps=${this.halfsteps}&newFormat=false`,{headers:f});this.formatContent(t.data?.content||"");}},u=class a{data;constructor(t=[]){this.data=t;}push(...t){this.data.push(...t);}lyrics(){return new a(this.data.map(t=>t.lyrics()))}noTabs(){return new a(this.data.map(t=>t.noTabs()))}chords(){return new a(this.data.map(t=>t.chords()))}},p=class a{static async search(t){let r=_(t);try{let n=(await l__default.default.get(r)).data.trim().slice(1,-1);return JSON.parse(n).response.docs.map(o=>({path:`${o.d}/${o.u}`,hash:new URLSearchParams(""),name:o.m,author:o.a,position:0}))}catch{return []}}static async list(t){try{return (await l__default.default.get(`${b}/songbook/${t}`,{headers:f})).data?.songs?.map((e,s)=>{let[,n]=e.siteUrl.split("#"),i=e.apiUrl.split("version/")[1];return {position:s,path:`${e.apiUrl}${i?`/${i}.html`:""}`,hash:new URLSearchParams(n||""),name:e.name,author:e.artist.name,id:e.songId,tone_songbook:e.stdTone,tuning:e.tuning,version:i||"principal",capo_songbook:e.capo||0,minor:e.minor}})}catch(r){console.error(r);}return []}static async downloadList(t=[]){let r=new u;try{for(let e of t){console.log(`${e.name} - ${e.author} (${e.tone_songbook})`);let s=await a.get(e);s instanceof h&&r.push(s),await x(100);}}catch(e){console.error(e);}return r}static async get(t){try{let r=new h(t);return await r.get(),r}catch(r){console.log(r);}return  false}};var M=p;exports.Cifra=h;exports.CifraList=u;exports.default=M;

package/package.json

@@ -2,7 +2,7 @@
     "name": "cifraclub-wrapper",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
-    "version": "1.0.1",
+    "version": "1.0.2",
     "type": "commonjs",
     "files": [
         "dist"