brisa-sdk 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,23 @@
1
+ # Guia de atualização
2
+
3
+ Cada secção diz o que mudou, o **impacto** (alto, médio ou baixo) e o que fazer. Os SDKs seguem [versionamento semântico](https://semver.org/lang/pt-BR/): antes da 1.0, uma versão menor pode trazer mudanças.
4
+
5
+ ## De 0.1 para 0.2
6
+
7
+ Requer a API de 15 de novembro de 2026 ou posterior. Contra uma API anterior, os pedidos antigos continuam a funcionar.
8
+
9
+ ### Impacto baixo: novos papéis de impressão
10
+
11
+ `pdf({ format })` aceita agora `a5`, `thermal80` (igual a `thermal`) e `thermal58`. Nada a fazer.
12
+
13
+ ### Impacto baixo: pagamento com vários meios
14
+
15
+ `payment.payments` (até 6 meios) em `FR` e `TV`. O detalhe do documento traz `paymentMethod: "mixed"`, `payments` e `amountReceived`. Se mostra o meio de pagamento num ecrã seu, trate o valor `mixed`.
16
+
17
+ ### Impacto baixo: dados bancários
18
+
19
+ `bank()`, `setBank()`, `bankDetails` e `printBankDetails` ao emitir. O IBAN guarda-se como foi escrito, sem verificação.
20
+
21
+ ### Impacto baixo: clientes
22
+
23
+ `clients.list` aceita `sort`, `desc` e `totals`; novos `statement`, `statementPdf` e `statementCsv`.
package/package.json CHANGED
@@ -1,6 +1,69 @@
1
1
  {
2
2
  "name": "brisa-sdk",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.2.0",
4
+ "description": "SDK oficial da API Brisa (faturação certificada AGT, Angola) para Node.js e TypeScript.",
5
+ "license": "MIT",
6
+ "author": "Codespace <geral@codespace.ao>",
7
+ "homepage": "https://github.com/codespace-ao/brisa-sdk-js#readme",
8
+ "repository": {
9
+ "type": "git",
10
+ "url": "git+https://github.com/codespace-ao/brisa-sdk-js.git"
11
+ },
12
+ "bugs": "https://github.com/codespace-ao/brisa-sdk-js/issues",
13
+ "keywords": [
14
+ "brisa",
15
+ "faturacao",
16
+ "agt",
17
+ "angola",
18
+ "saft",
19
+ "invoicing",
20
+ "sdk"
21
+ ],
22
+ "type": "module",
23
+ "main": "./dist/index.cjs",
24
+ "module": "./dist/index.js",
25
+ "types": "./dist/index.d.ts",
26
+ "exports": {
27
+ ".": {
28
+ "import": {
29
+ "types": "./dist/index.d.ts",
30
+ "default": "./dist/index.js"
31
+ },
32
+ "require": {
33
+ "types": "./dist/index.d.cts",
34
+ "default": "./dist/index.cjs"
35
+ }
36
+ },
37
+ "./package.json": "./package.json"
38
+ },
39
+ "files": [
40
+ "dist",
41
+ "docs",
42
+ "README.md",
43
+ "CHANGELOG.md",
44
+ "LICENSE"
45
+ ],
46
+ "sideEffects": false,
47
+ "engines": {
48
+ "node": ">=18"
49
+ },
50
+ "scripts": {
51
+ "build": "tsup",
52
+ "lint": "biome check src test",
53
+ "format": "biome check --write src test examples",
54
+ "typecheck": "tsc --noEmit",
55
+ "test": "vitest run",
56
+ "test:integration": "vitest run test/integration.test.ts",
57
+ "prepublishOnly": "npm run lint && npm run typecheck && npm test && npm run build"
58
+ },
59
+ "publishConfig": {
60
+ "access": "public"
61
+ },
62
+ "devDependencies": {
63
+ "@biomejs/biome": "2.6.7",
64
+ "@types/node": "^20.17.0",
65
+ "tsup": "^8.3.0",
66
+ "typescript": "^5.6.0",
67
+ "vitest": "^2.1.0"
68
+ }
69
+ }