@12-apps/fiscal 1.0.0 → 1.1.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.
Files changed (140) hide show
  1. package/README.md +152 -7
  2. package/dist/chunk-27B4HNO6.js +574 -0
  3. package/dist/chunk-27B4HNO6.js.map +1 -0
  4. package/dist/chunk-3SDXLSG4.js +24 -0
  5. package/dist/chunk-3SDXLSG4.js.map +1 -0
  6. package/dist/chunk-ALABGVPO.js +247 -0
  7. package/dist/chunk-ALABGVPO.js.map +1 -0
  8. package/dist/chunk-FOFIN5M7.js +14 -0
  9. package/dist/chunk-FOFIN5M7.js.map +1 -0
  10. package/dist/chunk-HQ2NXSTX.js +85 -0
  11. package/dist/chunk-HQ2NXSTX.js.map +1 -0
  12. package/dist/chunk-PNTKG3DZ.js +47 -0
  13. package/dist/chunk-PNTKG3DZ.js.map +1 -0
  14. package/dist/chunk-RRFKYVLZ.js +192 -0
  15. package/dist/chunk-RRFKYVLZ.js.map +1 -0
  16. package/dist/chunk-V5ZQAAJT.js +210 -0
  17. package/dist/chunk-V5ZQAAJT.js.map +1 -0
  18. package/dist/chunk-X6MRDUYH.js +21 -0
  19. package/dist/chunk-X6MRDUYH.js.map +1 -0
  20. package/dist/chunk-XQGW5HUG.js +30 -0
  21. package/dist/chunk-XQGW5HUG.js.map +1 -0
  22. package/dist/context-ChnWR4Kb.d.ts +455 -0
  23. package/dist/danfe/en-US.d.ts +12 -0
  24. package/dist/danfe/en-US.js +51 -0
  25. package/dist/danfe/en-US.js.map +1 -0
  26. package/dist/danfe/index.d.ts +50 -0
  27. package/dist/danfe/index.js +18 -0
  28. package/dist/danfe/index.js.map +1 -0
  29. package/dist/danfe/pt-BR.d.ts +11 -0
  30. package/dist/danfe/pt-BR.js +51 -0
  31. package/dist/danfe/pt-BR.js.map +1 -0
  32. package/dist/documents/index.d.ts +169 -0
  33. package/dist/documents/index.js +1228 -0
  34. package/dist/documents/index.js.map +1 -0
  35. package/dist/engine/index.d.ts +3 -246
  36. package/dist/http.d.ts +73 -0
  37. package/dist/http.js +16 -0
  38. package/dist/http.js.map +1 -0
  39. package/dist/issuer/index.d.ts +43 -0
  40. package/dist/issuer/index.js +131 -0
  41. package/dist/issuer/index.js.map +1 -0
  42. package/dist/jobs.d.ts +74 -0
  43. package/dist/jobs.js +22 -0
  44. package/dist/jobs.js.map +1 -0
  45. package/dist/labels-BNvflT0h.d.ts +44 -0
  46. package/dist/manifest/index.d.ts +30 -16
  47. package/dist/manifest/index.js +11 -17
  48. package/dist/manifest/index.js.map +1 -1
  49. package/dist/manifest/server.d.ts +57 -0
  50. package/dist/manifest/server.js +25 -0
  51. package/dist/manifest/server.js.map +1 -0
  52. package/dist/notifications.d.ts +93 -0
  53. package/dist/notifications.js +41 -0
  54. package/dist/notifications.js.map +1 -0
  55. package/dist/port-DpRFK56U.d.ts +238 -0
  56. package/dist/sale/index.d.ts +243 -0
  57. package/dist/sale/index.js +1 -0
  58. package/dist/sale/index.js.map +1 -0
  59. package/dist/service-KTjH7AxW.d.ts +139 -0
  60. package/dist/sidecar/index.d.ts +216 -0
  61. package/dist/sidecar/index.js +8 -0
  62. package/dist/sidecar/index.js.map +1 -0
  63. package/dist/types-B1b8LIWX.d.ts +247 -0
  64. package/package.json +63 -5
  65. package/prisma/fiscal.prisma +158 -0
  66. package/prisma/migrations/20261113220000_fiscal_documents/migration.sql +201 -0
  67. package/sidecar/.dockerignore +5 -0
  68. package/sidecar/Dockerfile +68 -0
  69. package/sidecar/README.md +149 -0
  70. package/sidecar/composer.json +30 -0
  71. package/sidecar/composer.lock +2224 -0
  72. package/sidecar/docker/apache.conf +14 -0
  73. package/sidecar/docker/icp-brasil.pem +8031 -0
  74. package/sidecar/docker/mpm.conf +17 -0
  75. package/sidecar/docker/openssl.cnf +16 -0
  76. package/sidecar/docker/php.ini +19 -0
  77. package/sidecar/public/index.php +15 -0
  78. package/sidecar/schema/sale-for-document.schema.json +401 -0
  79. package/sidecar/src/ErrorClass.php +31 -0
  80. package/sidecar/src/Http/Request.php +48 -0
  81. package/sidecar/src/Http/Response.php +32 -0
  82. package/sidecar/src/Http/Router.php +59 -0
  83. package/sidecar/src/Kernel.php +99 -0
  84. package/sidecar/src/Module.php +31 -0
  85. package/sidecar/src/Nfe/Classifier.php +89 -0
  86. package/sidecar/src/Nfe/Credentials.php +52 -0
  87. package/sidecar/src/Nfe/DocumentMapper.php +383 -0
  88. package/sidecar/src/Nfe/DocumentSchema.php +39 -0
  89. package/sidecar/src/Nfe/Input.php +125 -0
  90. package/sidecar/src/Nfe/Model.php +17 -0
  91. package/sidecar/src/Nfe/NfeModule.php +62 -0
  92. package/sidecar/src/Nfe/NfeService.php +504 -0
  93. package/sidecar/src/Nfe/Sefaz.php +49 -0
  94. package/sidecar/src/Nfe/SefazReply.php +81 -0
  95. package/sidecar/src/Nfe/Transport/CurlTransport.php +198 -0
  96. package/sidecar/src/Nfe/Transport/SoapAdapter.php +57 -0
  97. package/sidecar/src/Nfe/Transport/Transport.php +20 -0
  98. package/sidecar/src/Nfe/Transport/TransportFailure.php +42 -0
  99. package/sidecar/src/RequestLog.php +54 -0
  100. package/sidecar/src/ServiceError.php +69 -0
  101. package/src/danfe/en-US.ts +53 -0
  102. package/src/danfe/index.ts +11 -0
  103. package/src/danfe/labels.ts +49 -0
  104. package/src/danfe/pt-BR.ts +52 -0
  105. package/src/danfe/render.ts +265 -0
  106. package/src/danfe/xml.ts +45 -0
  107. package/src/documents/context.ts +260 -0
  108. package/src/documents/errors.ts +41 -0
  109. package/src/documents/helpers.ts +128 -0
  110. package/src/documents/index.ts +39 -0
  111. package/src/documents/lines.ts +63 -0
  112. package/src/documents/machine-steps.ts +260 -0
  113. package/src/documents/machine.ts +128 -0
  114. package/src/documents/memory.ts +138 -0
  115. package/src/documents/nfe-proc.ts +51 -0
  116. package/src/documents/ports.ts +130 -0
  117. package/src/documents/profile-input.ts +168 -0
  118. package/src/documents/profile.ts +98 -0
  119. package/src/documents/service-profile.ts +104 -0
  120. package/src/documents/service.ts +296 -0
  121. package/src/documents/settle.ts +121 -0
  122. package/src/documents/signing.ts +61 -0
  123. package/src/documents/sql-rows.ts +180 -0
  124. package/src/documents/sql-store.ts +242 -0
  125. package/src/documents/sql.ts +18 -0
  126. package/src/documents/steps.ts +173 -0
  127. package/src/documents/tests/integration/pglite.ts +73 -0
  128. package/src/documents/types.ts +193 -0
  129. package/src/http.ts +264 -0
  130. package/src/issuer/index.ts +9 -0
  131. package/src/issuer/port.ts +109 -0
  132. package/src/issuer/sidecar.ts +171 -0
  133. package/src/jobs.ts +115 -0
  134. package/src/manifest/index.ts +25 -16
  135. package/src/manifest/server.ts +20 -0
  136. package/src/notifications.ts +120 -0
  137. package/src/sale/index.ts +8 -0
  138. package/src/sale/types.ts +292 -0
  139. package/src/sidecar/index.ts +9 -0
  140. package/src/sidecar/types.ts +243 -0
@@ -0,0 +1,39 @@
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ namespace Fiscal\Sidecar\Nfe;
6
+
7
+ use Fiscal\Sidecar\ServiceError;
8
+ use JsonSchema\Constraints\Constraint;
9
+ use JsonSchema\Validator;
10
+
11
+ /**
12
+ * The neutral document's JSON schema — the very file `@12-apps/fiscal`
13
+ * publishes beside its `SaleForDocument` type.
14
+ */
15
+ final class DocumentSchema
16
+ {
17
+ public const PATH = __DIR__ . '/../../schema/sale-for-document.schema.json';
18
+
19
+ /**
20
+ * @param mixed $document the decoded JSON (arrays)
21
+ * @throws ServiceError INVALID, one detail per violation
22
+ */
23
+ public static function assertValid(mixed $document): void
24
+ {
25
+ $schema = json_decode((string) file_get_contents(self::PATH));
26
+ $data = json_decode((string) json_encode($document));
27
+ $validator = new Validator();
28
+ $validator->validate($data, $schema, Constraint::CHECK_MODE_NORMAL);
29
+ if ($validator->isValid()) {
30
+ return;
31
+ }
32
+ $details = [];
33
+ foreach ($validator->getErrors() as $error) {
34
+ $where = $error['property'] !== '' ? $error['property'] : '(document)';
35
+ $details[] = "$where: {$error['message']}";
36
+ }
37
+ throw ServiceError::invalid('The document does not match the SaleForDocument schema.', $details);
38
+ }
39
+ }
@@ -0,0 +1,125 @@
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ namespace Fiscal\Sidecar\Nfe;
6
+
7
+ use Fiscal\Sidecar\ServiceError;
8
+
9
+ /**
10
+ * The envelope fields of a request, read with their rules. A field that breaks
11
+ * one is INVALID, named, and its value is never quoted back (it may be the
12
+ * password).
13
+ */
14
+ final class Input
15
+ {
16
+ /** @param array<string, mixed> $body */
17
+ public function __construct(private readonly array $body)
18
+ {
19
+ }
20
+
21
+ /** `tpAmb`: 1 production, 2 homologação. */
22
+ public function environment(): int
23
+ {
24
+ return match ($this->body['environment'] ?? null) {
25
+ 'producao' => 1,
26
+ 'homologacao' => 2,
27
+ default => throw ServiceError::invalid('environment must be "homologacao" or "producao".'),
28
+ };
29
+ }
30
+
31
+ /** @return array{pfx: string, password: string} */
32
+ public function certificate(): array
33
+ {
34
+ $certificate = $this->body['certificate'] ?? null;
35
+ if (!is_array($certificate) || !is_string($certificate['pfxBase64'] ?? null)
36
+ || !is_string($certificate['password'] ?? null)) {
37
+ throw ServiceError::invalid('certificate must be { pfxBase64, password }.');
38
+ }
39
+ $pfx = base64_decode($certificate['pfxBase64'], true);
40
+ if ($pfx === false || $pfx === '') {
41
+ throw ServiceError::invalid('certificate.pfxBase64 is not base64.');
42
+ }
43
+ return ['pfx' => $pfx, 'password' => $certificate['password']];
44
+ }
45
+
46
+ /** @return array{id: string, token: string}|null */
47
+ public function csc(Model $model): ?array
48
+ {
49
+ $csc = $this->body['csc'] ?? null;
50
+ if ($model === Model::NFE) {
51
+ if ($csc !== null) {
52
+ throw ServiceError::invalid('csc belongs to an NFC-e; an NF-e takes null.');
53
+ }
54
+ return null;
55
+ }
56
+ if (!is_array($csc) || !is_string($csc['id'] ?? null) || !is_string($csc['token'] ?? null)
57
+ || preg_match('/^[0-9]{1,6}$/', $csc['id']) !== 1 || strlen($csc['token']) < 16
58
+ || strlen($csc['token']) > 36) {
59
+ throw ServiceError::invalid('An NFC-e needs csc: { id: up to 6 digits, token: 16 to 36 characters }.');
60
+ }
61
+ return ['id' => $csc['id'], 'token' => $csc['token']];
62
+ }
63
+
64
+ /** @return array<string, mixed> */
65
+ public function document(): array
66
+ {
67
+ $document = $this->body['document'] ?? null;
68
+ if (!is_array($document)) {
69
+ throw ServiceError::invalid('document must be a SaleForDocument object.');
70
+ }
71
+ DocumentSchema::assertValid($document);
72
+ return $document;
73
+ }
74
+
75
+ /** @return array{since: string, reason: string} */
76
+ public function contingency(): array
77
+ {
78
+ $contingency = $this->body['contingency'] ?? null;
79
+ $since = is_array($contingency) ? ($contingency['since'] ?? null) : null;
80
+ $reason = is_array($contingency) ? ($contingency['reason'] ?? null) : null;
81
+ if (!is_string($since) || \DateTimeImmutable::createFromFormat(DATE_ATOM, $since) === false
82
+ || !is_string($reason) || mb_strlen(trim($reason)) < 15 || mb_strlen($reason) > 256) {
83
+ throw ServiceError::invalid(
84
+ 'contingency must be { since: ISO 8601 with offset, reason: 15 to 256 characters }.',
85
+ );
86
+ }
87
+ return ['since' => $since, 'reason' => trim($reason)];
88
+ }
89
+
90
+ public function accessKey(string $field = 'accessKey'): string
91
+ {
92
+ $key = $this->body[$field] ?? null;
93
+ if (!is_string($key) || preg_match('/^[0-9]{6}[A-Z0-9]{12}[0-9]{26}$/', $key) !== 1) {
94
+ throw ServiceError::invalid("$field must be the 44-character access key.");
95
+ }
96
+ return $key;
97
+ }
98
+
99
+ public function digits(string $field, int $min, int $max): int
100
+ {
101
+ $value = $this->body[$field] ?? null;
102
+ if (!is_int($value) || $value < $min || $value > $max) {
103
+ throw ServiceError::invalid("$field must be an integer from $min to $max.");
104
+ }
105
+ return $value;
106
+ }
107
+
108
+ public function text(string $field, int $min, int $max): string
109
+ {
110
+ $value = $this->body[$field] ?? null;
111
+ if (!is_string($value) || mb_strlen(trim($value)) < $min || mb_strlen($value) > $max) {
112
+ throw ServiceError::invalid("$field must be text of $min to $max characters.");
113
+ }
114
+ return trim($value);
115
+ }
116
+
117
+ public function pattern(string $field, string $regex, string $rule): string
118
+ {
119
+ $value = $this->body[$field] ?? null;
120
+ if (!is_string($value) || preg_match($regex, $value) !== 1) {
121
+ throw ServiceError::invalid("$field must be $rule.");
122
+ }
123
+ return $value;
124
+ }
125
+ }
@@ -0,0 +1,17 @@
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ namespace Fiscal\Sidecar\Nfe;
6
+
7
+ /** The two document models sped-nfe issues, by their path segment. */
8
+ enum Model: string
9
+ {
10
+ case NFE = 'nfe';
11
+ case NFCE = 'nfce';
12
+
13
+ public function code(): int
14
+ {
15
+ return $this === self::NFE ? 55 : 65;
16
+ }
17
+ }
@@ -0,0 +1,62 @@
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ namespace Fiscal\Sidecar\Nfe;
6
+
7
+ use Composer\InstalledVersions;
8
+ use Fiscal\Sidecar\Http\Request;
9
+ use Fiscal\Sidecar\Http\Response;
10
+ use Fiscal\Sidecar\Http\Router;
11
+ use Fiscal\Sidecar\Module;
12
+ use Fiscal\Sidecar\Nfe\Transport\Transport;
13
+
14
+ /**
15
+ * sped-nfe behind the service: models 55 (`/nfe/...`) and 65 (`/nfce/...`),
16
+ * and `/inutilize`, which names its model in the body.
17
+ */
18
+ final class NfeModule implements Module
19
+ {
20
+ /** The schema package the layout is built and validated against (Pacote de Liberação 010f). */
21
+ public const SCHEMES = 'PL_010_V1.30';
22
+ public const LIBRARY = 'nfephp-org/sped-nfe';
23
+
24
+ public function __construct(private readonly Transport $transport)
25
+ {
26
+ }
27
+
28
+ public function register(Router $router): void
29
+ {
30
+ foreach (Model::cases() as $model) {
31
+ $prefix = '/' . $model->value;
32
+ $router->add('POST', "$prefix/issue", fn (Request $r): Response => $this->service()->issue($model, self::in($r)));
33
+ $router->add('POST', "$prefix/transmit", fn (Request $r): Response => $this->service()->transmit($model, self::in($r)));
34
+ $router->add('POST', "$prefix/cancel", fn (Request $r): Response => $this->service()->cancel($model, self::in($r)));
35
+ $router->add('POST', "$prefix/lookup", fn (Request $r): Response => $this->service()->lookup($model, self::in($r)));
36
+ }
37
+ $router->add('POST', '/nfce/cancel-substitution', fn (Request $r): Response => $this->service()->cancelBySubstitution(self::in($r)));
38
+ $router->add('POST', '/nfce/sign-contingency', fn (Request $r): Response => $this->service()->signContingency(self::in($r)));
39
+ $router->add('POST', '/inutilize', fn (Request $r): Response => $this->service()->inutilize(self::in($r)));
40
+ }
41
+
42
+ public function libraries(): array
43
+ {
44
+ return [self::LIBRARY => (string) InstalledVersions::getPrettyVersion(self::LIBRARY)];
45
+ }
46
+
47
+ public function health(): array
48
+ {
49
+ return ['nfeSchemas' => self::SCHEMES, 'sefazTlsVerify' => $this->transport->verifiesServer()];
50
+ }
51
+
52
+ /** A fresh service per call: nothing one call opens is reachable from the next. */
53
+ private function service(): NfeService
54
+ {
55
+ return new NfeService($this->transport);
56
+ }
57
+
58
+ private static function in(Request $request): Input
59
+ {
60
+ return new Input($request->json());
61
+ }
62
+ }