nfse-br 0.0.0-stage → 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Caio Henrique Agiani Pimenta
+
+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/README.md

@@ -1,3 +1,184 @@
-# Temporary Holding Version
+# nfse-br
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Node/TypeScript client and CLI for Brazilian service invoices (NFS-e), with two issuing
+systems behind one certificate and one command line:
+
+- **Sistema Nacional NFS-e** (SEFIN + ADN): the national issuer, and the way to issue for the
+  **Simples Nacional** since 2026-11-01 (Res. CGSN 191/2026). Issue, cancel, query, DANFSe.
+  See [docs/national.md](docs/national.md).
+- **GissOnline** (legacy for the Simples): the Web Services of **32 cities** (24 in São Paulo,
+  including Guarulhos, Santos and Santo André). It follows ABRASF 2.04 with the LC 214/2025
+  extensions (NT SE/CGNFS-e nº 007). The city is one environment variable; see
+  [docs/municipalities.md](docs/municipalities.md).
+
+Formerly `gissonline-nfse`. The `giss` command and `GissClient` still work as aliases.
+
+On GissOnline it covers all **16 operations** of the two published SOAP services: `nfse`
+(services provided) and `nfsc` (services received). It also covers the portal REST API,
+the only way to reach the customer and supplier directory and the municipal activity table.
+
+- Issue, cancel and replace invoices, single or in batches
+- Queries by period, competence, number range, RPS and protocol
+- The city activity table, where `CodigoTributacaoMunicipio` and its LC 116 item come from
+- Declaration of received services (supplier invoices)
+- XMLDSig signing with an A1 certificate, in the shape each operation requires
+- Portal login with that same certificate, so no CPF and password are needed
+- Fale Conosco messages: read the replies from the city hall, and open new ones
+- Validation against the official XSD before sending
+- National issuer: issue, cancel, query, DANFSe and the distribution of every invoice
+  where your CNPJ appears
+- Typed errors that say whether a retry is safe; see [docs/errors.md](docs/errors.md)
+- No write operation fires without `--confirm`
+
+## Which system issues?
+
+| Taxpayer | Issue with | Notes |
+| --- | --- | --- |
+| ME/EPP in the Simples Nacional | **National** (the default) | GissOnline stopped issuing for them on 2026-11-01. Confirmed in production (Suzano, 2026-11-13) |
+| Not in the Simples | National is also the default | In a city that has not adopted it, `issue` answers `E0039`: pass `--issuer giss` (check with `nfse national-status`) |
+| MEI | National web issuer | Not exercised by this client; RN 239 exempts MEI from the city agreement too |
+
+GissOnline is still the way to **read** what it already holds: invoices issued until
+2026-10-31, the customer and supplier directory, the activity table and the Fale Conosco
+messages. Its issuing, cancelling and replacing are still in the client, but a Simples optant
+should not count on them: GissOnline blocks them since 2026-11-01, and on 2026-11-13 its
+homologation environment refused an RPS with `E160` (schema). Not tested in production.
+
+Numbering is separate: the national system numbers invoices from 1 per issuer, apart from
+GissOnline's sequence. `nDPS` (the request number) is yours to choose with `--dps`.
+
+## Requirements
+
+- Node 22+. Running from the repository without a build needs 22.18+, where `.ts` files
+  execute natively
+- A1 ICP-Brasil digital certificate (`.pfx`) for the provider
+- `xmllint` (optional) — enables XSD validation before sending
+
+## Install
+
+### As a package
+
+```bash
+npm install nfse-br        # in a project
+npm install -g nfse-br     # or globally, for the nfse command
+```
+
+The `nfse` binary (with `giss` kept as an alias) becomes available in the shell and reads the `.env` of the current
+directory. Shell completion for bash and zsh is described in [docs/cli.md](docs/cli.md#shell-completion).
+
+### From the repository
+
+```bash
+npm install
+cp .env.example .env                    # fill in the credentials
+cp /path/to/certificate.pfx cert/       # the folder ships empty
+npm run nfse -- latest                  # same as `nfse latest`
+```
+
+Scripts: `npm run build` (compiles to `dist/`), `npm run typecheck`, `npm run nfse`.
+
+`cert/` and `data/` are versioned empty (just a `.gitkeep`) to mark where the files go —
+their contents never enter the repository.
+
+## Quick start
+
+```bash
+# National issuer — the default for `issue` (use --issuer giss for a city that has not adopted it)
+nfse national-status                      # the city's agreement (see docs/national.md)
+nfse issue --customer acme --amount 1500 --description "Consulting" --dps 7
+nfse issue --customer acme --amount 1500 --description "Consulting" --dps 7 --confirm
+nfse national-pdf --key <50-digit key>    # the DANFSe, rendered from the invoice XML
+nfse cancel --key <key> --reason 1 --text "Wrong service code, will be reissued" --confirm
+```
+
+For an ME/EPP apportioned through the Simples the DPS carries no ISS rate (the DAS carries
+it). Pass `--item`, `--cnae` and `--nbs` of the service you are billing: the default profile
+is software development. Use `--dps N` in sequence so a retry is safe. The step by step, with
+what the service refused and why, is in [docs/national.md](docs/national.md).
+
+```bash
+# GissOnline (queries, directory, and issuing where the city still serves you)
+nfse latest                               # the most recent invoices
+nfse activities --company                 # activity codes this company can use
+nfse issue --issuer giss --customer acme --amount 1500 --description "Consulting"
+nfse issue --issuer giss --customer acme --amount 1500 --description "Consulting" --confirm
+nfse pdf --number 573                     # the invoice as a file
+```
+
+```ts
+import { NfseClient, PortalService } from "nfse-br";
+
+// `nfse` and `nfsc` are the two Web Services; `config` and `certificate` come
+// resolved. Destructuring a service is safe — destructuring a method is not.
+const { nfse, config, certificate } = new NfseClient();
+
+const { invoices } = await nfse.queryProvidedServices({
+  issuePeriod: { from: "2026-07-01", to: "2026-07-31" },
+});
+
+// CodigoTributacaoMunicipio and its LC 116 item, from the city's own table.
+// This route is public — no login, no certificate:
+const activities = await PortalService.listActivities(config.cityCode);
+// [{ code: "6319400", serviceListItem: "1.09", description: "Portais…", rate: 4 }, …]
+
+// Anything company-specific needs a session. The A1 that signs the RPS opens
+// the portal too, so no CPF and password are required:
+const portal = await PortalService.authenticate({ certificate, cityCode: config.cityCode });
+const mine = await portal.companyActivities();   // rate valid today, by default
+```
+
+Nothing that writes fires without `--confirm`.
+
+## Documentation
+
+| | |
+| --- | --- |
+| [examples/](examples/) | Runnable scripts, all checked against production |
+| [docs/cli.md](docs/cli.md) | Every command, completion, documents and lookups |
+| [docs/municipalities.md](docs/municipalities.md) | The cities that publish the Web Service |
+| [docs/library.md](docs/library.md) | Using it as a package, and the 16 operations |
+| [docs/configuration.md](docs/configuration.md) | `.env`, serving several companies, tax profile, homologation |
+| [docs/issuing.md](docs/issuing.md) | What actually issues an invoice, and why |
+| [docs/national.md](docs/national.md) | The national issuer: the 2026-11-01 move for Simples Nacional, what the live service accepts, numbering |
+| [docs/errors.md](docs/errors.md) | Error codes, retries, and what is safe to repeat |
+| [docs/gotchas.md](docs/gotchas.md) | What the live service taught us the hard way |
+| [docs/architecture.md](docs/architecture.md) | Layers, patterns, mTLS, SOAP and the signature |
+
+Under `docs/`: technical manuals (Services Provided v1.6, Services Received/CST v2.5,
+PIS/COFINS/CSLL v1.0), XML samples and the errors and alerts spreadsheet. The XSD live
+in `schemas/`, one folder per provider.
+Source: <https://suzano.giss.com.br/giss-ajuda/desenvolvedores.html>.
+
+`schemas/giss/tomados/vigente/` carries the services-received XSD with the `tipos` v1_01
+merged over v1_00 — necessary because the published v1_01 is a delta that does not compile
+on its own. The originals stay untouched in the directory above.
+
+## Security
+
+Never committed (already covered by `.gitignore`):
+
+- `.env` — certificate password and portal credentials
+- `cert/*` — the `.pfx` and exported PEM files (the key is written **without a passphrase**,
+  mode `0600`)
+- `data/*` — local directory and tax profile, holding third-party data
+
+Two notes on the code: the `APP_ID` in `portal-service.ts` is not a secret — it is a public
+constant from the portal bundle, sent by any browser that opens the site. And the signature
+uses `rsa-sha1` with a `sha1` digest: weak by today's standards, but it is what the service
+validates (manual, section 6.3).
+
+## Contributing
+
+Commits follow [Conventional Commits](https://www.conventionalcommits.org), enforced by a
+local hook and a CI check. See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Disclaimer
+
+Independent project, not affiliated with Eicon, GissOnline or the Comitê Gestor da NFS-e. The portal REST API is
+internal and has no public contract — it may change without notice. Issuing, cancelling or
+replacing an invoice has real tax effects: check the profile values with your accountant
+before using `--confirm` in production.
+
+## License
+
+MIT

package/assets/fonts/LICENSE-LiberationSans.txt

@@ -0,0 +1,102 @@
+Digitized data copyright (c) 2010 Google Corporation
+	with Reserved Font Arimo, Tinos and Cousine.
+Copyright (c) 2012 Red Hat, Inc.
+	with Reserved Font Name Liberation.
+
+This Font Software is licensed under the SIL Open Font License,
+Version 1.1.
+
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+
+PREAMBLE The goals of the Open Font License (OFL) are to stimulate
+worldwide development of collaborative font projects, to support the font
+creation efforts of academic and linguistic communities, and to provide
+a free and open framework in which fonts may be shared and improved in
+partnership with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves.
+The fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works.  The fonts and derivatives,
+however, cannot be released under any other type of license.  The
+requirement for fonts to remain under this license does not apply to
+any document created using the fonts or their derivatives.
+
+ 
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such.
+This may include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components
+as distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting ? in part or in whole ?
+any of the components of the Original Version, by changing formats or
+by porting the Font Software to a new environment.
+
+"Author" refers to any designer, engineer, programmer, technical writer
+or other person who contributed to the Font Software.
+
+
+PERMISSION & CONDITIONS
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,in
+   Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+   redistributed and/or sold with any software, provided that each copy
+   contains the above copyright notice and this license. These can be
+   included either as stand-alone text files, human-readable headers or
+   in the appropriate machine-readable metadata fields within text or
+   binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+   Name(s) unless explicit written permission is granted by the
+   corresponding Copyright Holder. This restriction only applies to the
+   primary font name as presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+   Software shall not be used to promote, endorse or advertise any
+   Modified Version, except to acknowledge the contribution(s) of the
+   Copyright Holder(s) and the Author(s) or with their explicit written
+   permission.
+
+5) The Font Software, modified or unmodified, in part or in whole, must
+   be distributed entirely under this license, and must not be distributed
+   under any other license. The requirement for fonts to remain under
+   this license does not apply to any document created using the Font
+   Software.
+
+
+ 
+TERMINATION
+This license becomes null and void if any of the above conditions are not met.
+
+ 
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT.  IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER
+DEALINGS IN THE FONT SOFTWARE.
+

package/completions/_nfse

@@ -0,0 +1,200 @@
+#compdef nfse giss
+# Zsh completion for the nfse CLI (and its giss alias).
+#
+#   mkdir -p ~/.zsh/completions
+#   cp completions/_nfse ~/.zsh/completions/
+#   # in ~/.zshrc, before `compinit`:
+#   fpath=(~/.zsh/completions $fpath)
+#
+# With oh-my-zsh, ~/.oh-my-zsh/completions is already on fpath.
+
+_nfse() {
+  local -a commands global_opts
+  local context state line
+
+  commands=(
+    'cert:A1 certificate details'
+    'latest:Most recent invoices'
+    'issued:Invoices by issue or competence period'
+    'range:Invoices by number range'
+    'rps:Invoice generated from an RPS'
+    'batch:Status of an RPS batch'
+    'received:Invoices where you are the customer'
+    'purchased-batch:Invoices declared in a batch (nfsc)'
+    'purchased-protocol:Status of a protocol (nfsc)'
+    'purchased-number:Received invoices by declared number'
+    'issue:Issue an invoice'
+    'cancel:Cancel an invoice'
+    'replace:Cancel and reissue an invoice'
+    'customers:List or sync customers'
+    'suppliers:List or sync suppliers'
+    'customer-add:Add a customer to the local directory'
+    'supplier-add:Add a supplier to the local directory'
+    'customer-rm:Remove a customer'
+    'supplier-rm:Remove a supplier'
+    'portal-list:Portal directory'
+    'portal-add:Register in the portal'
+    'portal-rm:Remove from the portal'
+    'portal-import:Import the portal directory'
+    'pdf:Download the invoice PDF'
+    'xml:Download the invoice XML'
+    'cities:Cities known to publish the Web Service'
+    'activities:Municipal activity table (CodigoTributacaoMunicipio)'
+    'messages:Fale Conosco messages you opened'
+    'message:Open a message to the city hall'
+    'zip:Look up a postal code (BrasilAPI)'
+    'cnpj:Look up a company by CNPJ (BrasilAPI)'
+    'profile:Show or save the tax profile defaults'
+    'national-status:City adhesion to the national issuer'
+    'national-get:National invoice by access key'
+    'national-pdf:Download the DANFSe'
+    'national-xml:Download the national invoice XML'
+    'national-docs:Invoices and events where your CNPJ appears'
+    'danfse:DANFSe from a saved national XML (offline)'
+  )
+
+  global_opts=(
+    '--env[Environment]:environment:(producao homologacao)'
+    '--issuer[Who issues]:issuer:(giss nacional)'
+    '--json[JSON output]'
+    '--xml[Raw XML output]'
+    '--debug[Log the XML sent and received]'
+    '--help[Show help]'
+  )
+
+  _arguments -C \
+    '1: :->command' \
+    '*:: :->args' && return 0
+
+  case $state in
+    command)
+      _describe -t commands 'giss command' commands && return 0
+      ;;
+    args)
+      case $words[1] in
+        cert)
+          _arguments $global_opts '--export[Write the PEM files]' '--out[Target directory]:directory:_files -/'
+          ;;
+        latest)
+          _arguments $global_opts '--limit[How many invoices]:number:' '--months[How far back]:number:'
+          ;;
+        issued|received)
+          _arguments $global_opts \
+            '--from[Start date]:date (YYYY-MM-DD):' \
+            '--to[End date]:date (YYYY-MM-DD):' \
+            '--competence[Use the competence period]' \
+            '--number[Specific invoice number]:number:' \
+            '--page[Result page]:number:' \
+            '--all[Walk every page]'
+          ;;
+        range)
+          _arguments $global_opts '--first[First number]:number:' '--last[Last number]:number:' '--page[Result page]:number:'
+          ;;
+        rps)
+          _arguments $global_opts '--number[RPS number]:number:' '--series[RPS series]:series:' '--type[RPS type]:type:(1 2 3)'
+          ;;
+        batch|purchased-batch|purchased-protocol)
+          _arguments $global_opts '--protocol[Protocol]:protocol:'
+          ;;
+        purchased-number)
+          _arguments $global_opts '--from[Start date]:date:' '--to[End date]:date:' \
+            '--number[Declared number]:number:' '--series[Declared series]:series:'
+          ;;
+        issue)
+          _arguments $global_opts \
+            '--customer[Tax id or alias]:customer:' \
+            '--amount[Service amount]:amount:' \
+            '--description[Service description]:text:' \
+            '--competence[Competence date]:date (YYYY-MM-DD):' \
+            '--rps[RPS number]:number:' \
+            '--series[RPS series]:series:' \
+            '--item[LC 116 item]:item:' \
+            '--cnae[CNAE code]:code:' \
+            '--nbs[NBS code]:code:' \
+            '--rate[ISS rate in percent]:rate:' \
+            '--csll[CSLL withheld]:amount:' \
+            '--inss[INSS withheld]:amount:' \
+            '--income-tax[Income tax withheld]:amount:' \
+            '--notes[Additional information]:text:' \
+            '--confirm[Actually issue it]'
+          ;;
+        cancel)
+          _arguments $global_opts '--number[Invoice number]:number:' \
+            '--reason[Cancellation reason]:reason:((1\:"issuing error" 2\:"service not provided" 3\:"signature error" 4\:"duplicate invoice" 5\:"processing error"))' \
+            '--confirm[Actually cancel it]'
+          ;;
+        replace)
+          _arguments $global_opts '--number[Invoice number]:number:' \
+            '--reason[Cancellation reason]:reason:(1 2 3 4 5)' \
+            '--customer[Tax id or alias]:customer:' '--amount[Service amount]:amount:' \
+            '--description[Service description]:text:' '--confirm[Actually replace it]'
+          ;;
+        customers|suppliers)
+          _arguments $global_opts '--sync[Sync from invoices]' '--from[Start date]:date:' '--to[End date]:date:'
+          ;;
+        customer-add|supplier-add|portal-add)
+          _arguments $global_opts \
+            '--tax-id[CPF or CNPJ]:tax id:' '--name[Legal name]:name:' '--alias[Short alias]:alias:' \
+            '--registration[Municipal registration]:number:' '--email[Email]:email:' '--phone[Phone]:phone:' \
+            '--trade-name[Trade name]:name:' '--street[Street]:street:' '--number[Street number]:number:' \
+            '--district[District]:district:' '--city[City IBGE code]:code:' '--state[State]:uf:' \
+            '--zip[Zip code]:zip:' '--complement[Complement]:text:' '--street-type[Street type]:type:' \
+            '--simples[Simples Nacional]:option:(1 2)' '--mei[MEI]' '--type[Role]:role:((1\:customer 2\:supplier))' \
+            '--confirm[Actually save it]'
+          ;;
+        customer-rm|supplier-rm)
+          _arguments $global_opts '--tax-id[CPF or CNPJ]:tax id:'
+          ;;
+        portal-rm)
+          _arguments $global_opts '--tax-id[CPF or CNPJ]:tax id:' '--type[Role]:role:(1 2)' '--confirm[Actually remove it]'
+          ;;
+        portal-list|portal-import)
+          _arguments $global_opts '--type[Role]:role:((1\:customer 2\:supplier))'
+          ;;
+        pdf|xml)
+          _arguments $global_opts '--number[Invoice number]:number:' \
+            '--out[Target directory or file]:target:_files'
+          ;;
+        cities)
+          _arguments $global_opts '--state[Filter by state]:uf:(AL GO MG PE PR SP)'
+          ;;
+        messages)
+          _arguments $global_opts '--id[Message id]:id:' '--unread[Only unanswered replies]' \
+            '--attachment[Attachment id to download]:id:' '--out[Target directory]:directory:_files -/' \
+            '--city[City IBGE code]:code:'
+          ;;
+        message)
+          _arguments $global_opts '--subject[Subject]:text:' '--text[Message body]:text:' \
+            '--city[City IBGE code]:code:' '--confirm[Actually send it]'
+          ;;
+        activities)
+          _arguments $global_opts '--item[LC 116 item]:item:' '--city[City IBGE code]:code:' \
+            '--company[Only what the company is bound to]' '--date[Rate valid on this date]:date (YYYY-MM-DD):'
+          ;;
+        national-get)
+          _arguments $global_opts '--key[50-digit access key]:key:'
+          ;;
+        national-pdf|national-xml)
+          _arguments $global_opts '--key[50-digit access key]:key:' \
+            '--out[Target directory or file]:target:_files'
+          ;;
+        national-docs)
+          _arguments $global_opts '--from[Start after this NSU]:nsu:'
+          ;;
+        danfse)
+          _arguments $global_opts '*--event[Event XML of the invoice]:event:_files -g "*.xml"' \
+            '--status[Watermark]:status:(cancelled replaced)' \
+            '--out[Target directory or file]:target:_files' '1:invoice XML:_files -g "*.xml"'
+          ;;
+        profile)
+          _arguments $global_opts '--save[Write to data/profile.json]'
+          ;;
+        *)
+          _arguments $global_opts
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_nfse "$@"

package/completions/nfse.bash

@@ -0,0 +1,69 @@
+# Bash completion for the nfse CLI (and its giss alias). For zsh use `_nfse` in this same folder.
+#   source completions/nfse.bash
+# or copy it to /usr/local/etc/bash_completion.d/ (or /etc/bash_completion.d/).
+_nfse_completions() {
+  local cur prev commands global_opts opts
+  cur="${COMP_WORDS[COMP_CWORD]}"
+  prev="${COMP_WORDS[COMP_CWORD-1]}"
+
+  commands="cert latest issued range rps batch received purchased-batch \
+purchased-protocol purchased-number issue cancel replace customers \
+suppliers customer-add supplier-add customer-rm supplier-rm \
+portal-list portal-add portal-rm portal-import pdf xml zip cnpj cities \
+activities messages message profile national-status national-get \
+national-pdf national-xml national-docs danfse"
+
+  global_opts="--env --issuer --json --xml --debug --help"
+
+  # known values for some flags
+  case "$prev" in
+    --env)     COMPREPLY=($(compgen -W "producao homologacao" -- "$cur")); return ;;
+    --issuer)  COMPREPLY=($(compgen -W "giss nacional" -- "$cur")); return ;;
+    --reason)  COMPREPLY=($(compgen -W "1 2 3 4 5" -- "$cur")); return ;;
+    --type)    COMPREPLY=($(compgen -W "1 2" -- "$cur")); return ;;
+    --simples) COMPREPLY=($(compgen -W "1 2" -- "$cur")); return ;;
+    --out)     COMPREPLY=($(compgen -d -- "$cur")); return ;;
+  esac
+
+  # first argument: the command
+  if [ "$COMP_CWORD" -eq 1 ]; then
+    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+    return
+  fi
+
+  case "${COMP_WORDS[1]}" in
+    cert)            opts="--export --out" ;;
+    latest)          opts="--limit --months" ;;
+    issued|received) opts="--from --to --competence --number --page --all" ;;
+    range)           opts="--first --last --page" ;;
+    rps)             opts="--number --series --type" ;;
+    batch|purchased-batch|purchased-protocol) opts="--protocol" ;;
+    purchased-number) opts="--from --to --number --series" ;;
+    issue)           opts="--customer --amount --description --competence --rps --series \
+--item --cnae --nbs --rate --csll --inss --income-tax --notes --confirm" ;;
+    cancel)          opts="--number --reason --confirm" ;;
+    replace)         opts="--number --reason --customer --amount --description --confirm" ;;
+    customers|suppliers) opts="--sync --from --to" ;;
+    customer-add|supplier-add|portal-add)
+      opts="--tax-id --name --alias --registration --email --phone --trade-name \
+--street --number --district --city --state --zip --complement --street-type \
+--simples --mei --type --confirm" ;;
+    customer-rm|supplier-rm) opts="--tax-id" ;;
+    portal-rm)       opts="--tax-id --type --confirm" ;;
+    portal-list|portal-import) opts="--type" ;;
+    pdf|xml)         opts="--number --out" ;;
+    cities)          opts="--state" ;;
+    activities)      opts="--item --city --company --date" ;;
+    national-get)    opts="--key" ;;
+    national-pdf|national-xml) opts="--key --out" ;;
+    national-docs)   opts="--from" ;;
+    danfse)          opts="--event --status --out" ;;
+    messages)        opts="--id --unread --attachment --out --city" ;;
+    message)         opts="--subject --text --city --confirm" ;;
+    profile)         opts="--save" ;;
+    *)               opts="" ;;
+  esac
+
+  COMPREPLY=($(compgen -W "$opts $global_opts" -- "$cur"))
+}
+complete -F _nfse_completions nfse giss

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}