@12-apps/fiscal 0.0.0-stage → 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.
- package/README.md +269 -2
- package/dist/chunk-27B4HNO6.js +574 -0
- package/dist/chunk-27B4HNO6.js.map +1 -0
- package/dist/chunk-3SDXLSG4.js +24 -0
- package/dist/chunk-3SDXLSG4.js.map +1 -0
- package/dist/chunk-7QVYU63E.js +7 -0
- package/dist/chunk-7QVYU63E.js.map +1 -0
- package/dist/chunk-ALABGVPO.js +247 -0
- package/dist/chunk-ALABGVPO.js.map +1 -0
- package/dist/chunk-FOFIN5M7.js +14 -0
- package/dist/chunk-FOFIN5M7.js.map +1 -0
- package/dist/chunk-HQ2NXSTX.js +85 -0
- package/dist/chunk-HQ2NXSTX.js.map +1 -0
- package/dist/chunk-PNTKG3DZ.js +47 -0
- package/dist/chunk-PNTKG3DZ.js.map +1 -0
- package/dist/chunk-RRFKYVLZ.js +192 -0
- package/dist/chunk-RRFKYVLZ.js.map +1 -0
- package/dist/chunk-V5ZQAAJT.js +210 -0
- package/dist/chunk-V5ZQAAJT.js.map +1 -0
- package/dist/chunk-X6MRDUYH.js +21 -0
- package/dist/chunk-X6MRDUYH.js.map +1 -0
- package/dist/chunk-XQGW5HUG.js +30 -0
- package/dist/chunk-XQGW5HUG.js.map +1 -0
- package/dist/context-ChnWR4Kb.d.ts +455 -0
- package/dist/danfe/en-US.d.ts +12 -0
- package/dist/danfe/en-US.js +51 -0
- package/dist/danfe/en-US.js.map +1 -0
- package/dist/danfe/index.d.ts +50 -0
- package/dist/danfe/index.js +18 -0
- package/dist/danfe/index.js.map +1 -0
- package/dist/danfe/pt-BR.d.ts +11 -0
- package/dist/danfe/pt-BR.js +51 -0
- package/dist/danfe/pt-BR.js.map +1 -0
- package/dist/documents/index.d.ts +169 -0
- package/dist/documents/index.js +1228 -0
- package/dist/documents/index.js.map +1 -0
- package/dist/engine/index.d.ts +118 -0
- package/dist/engine/index.js +591 -0
- package/dist/engine/index.js.map +1 -0
- package/dist/http.d.ts +73 -0
- package/dist/http.js +16 -0
- package/dist/http.js.map +1 -0
- package/dist/issuer/index.d.ts +43 -0
- package/dist/issuer/index.js +131 -0
- package/dist/issuer/index.js.map +1 -0
- package/dist/jobs.d.ts +74 -0
- package/dist/jobs.js +22 -0
- package/dist/jobs.js.map +1 -0
- package/dist/labels-BNvflT0h.d.ts +44 -0
- package/dist/manifest/index.d.ts +97 -0
- package/dist/manifest/index.js +27 -0
- package/dist/manifest/index.js.map +1 -0
- package/dist/manifest/server.d.ts +57 -0
- package/dist/manifest/server.js +25 -0
- package/dist/manifest/server.js.map +1 -0
- package/dist/notifications.d.ts +93 -0
- package/dist/notifications.js +41 -0
- package/dist/notifications.js.map +1 -0
- package/dist/port-DpRFK56U.d.ts +238 -0
- package/dist/sale/index.d.ts +243 -0
- package/dist/sale/index.js +1 -0
- package/dist/sale/index.js.map +1 -0
- package/dist/service-KTjH7AxW.d.ts +139 -0
- package/dist/sidecar/index.d.ts +216 -0
- package/dist/sidecar/index.js +8 -0
- package/dist/sidecar/index.js.map +1 -0
- package/dist/types-B1b8LIWX.d.ts +247 -0
- package/package.json +126 -4
- package/prisma/fiscal.prisma +158 -0
- package/prisma/migrations/20261113220000_fiscal_documents/migration.sql +201 -0
- package/sidecar/.dockerignore +5 -0
- package/sidecar/Dockerfile +68 -0
- package/sidecar/README.md +149 -0
- package/sidecar/composer.json +30 -0
- package/sidecar/composer.lock +2224 -0
- package/sidecar/docker/apache.conf +14 -0
- package/sidecar/docker/icp-brasil.pem +8031 -0
- package/sidecar/docker/mpm.conf +17 -0
- package/sidecar/docker/openssl.cnf +16 -0
- package/sidecar/docker/php.ini +19 -0
- package/sidecar/public/index.php +15 -0
- package/sidecar/schema/sale-for-document.schema.json +401 -0
- package/sidecar/src/ErrorClass.php +31 -0
- package/sidecar/src/Http/Request.php +48 -0
- package/sidecar/src/Http/Response.php +32 -0
- package/sidecar/src/Http/Router.php +59 -0
- package/sidecar/src/Kernel.php +99 -0
- package/sidecar/src/Module.php +31 -0
- package/sidecar/src/Nfe/Classifier.php +89 -0
- package/sidecar/src/Nfe/Credentials.php +52 -0
- package/sidecar/src/Nfe/DocumentMapper.php +383 -0
- package/sidecar/src/Nfe/DocumentSchema.php +39 -0
- package/sidecar/src/Nfe/Input.php +125 -0
- package/sidecar/src/Nfe/Model.php +17 -0
- package/sidecar/src/Nfe/NfeModule.php +62 -0
- package/sidecar/src/Nfe/NfeService.php +504 -0
- package/sidecar/src/Nfe/Sefaz.php +49 -0
- package/sidecar/src/Nfe/SefazReply.php +81 -0
- package/sidecar/src/Nfe/Transport/CurlTransport.php +198 -0
- package/sidecar/src/Nfe/Transport/SoapAdapter.php +57 -0
- package/sidecar/src/Nfe/Transport/Transport.php +20 -0
- package/sidecar/src/Nfe/Transport/TransportFailure.php +42 -0
- package/sidecar/src/RequestLog.php +54 -0
- package/sidecar/src/ServiceError.php +69 -0
- package/src/danfe/en-US.ts +53 -0
- package/src/danfe/index.ts +11 -0
- package/src/danfe/labels.ts +49 -0
- package/src/danfe/pt-BR.ts +52 -0
- package/src/danfe/render.ts +265 -0
- package/src/danfe/xml.ts +45 -0
- package/src/documents/context.ts +260 -0
- package/src/documents/errors.ts +41 -0
- package/src/documents/helpers.ts +128 -0
- package/src/documents/index.ts +39 -0
- package/src/documents/lines.ts +63 -0
- package/src/documents/machine-steps.ts +260 -0
- package/src/documents/machine.ts +128 -0
- package/src/documents/memory.ts +138 -0
- package/src/documents/nfe-proc.ts +51 -0
- package/src/documents/ports.ts +130 -0
- package/src/documents/profile-input.ts +168 -0
- package/src/documents/profile.ts +98 -0
- package/src/documents/service-profile.ts +104 -0
- package/src/documents/service.ts +296 -0
- package/src/documents/settle.ts +121 -0
- package/src/documents/signing.ts +61 -0
- package/src/documents/sql-rows.ts +180 -0
- package/src/documents/sql-store.ts +242 -0
- package/src/documents/sql.ts +18 -0
- package/src/documents/steps.ts +173 -0
- package/src/documents/tests/integration/pglite.ts +73 -0
- package/src/documents/types.ts +193 -0
- package/src/engine/compare.ts +68 -0
- package/src/engine/compute.ts +40 -0
- package/src/engine/errors.ts +28 -0
- package/src/engine/index.ts +20 -0
- package/src/engine/oracle.ts +81 -0
- package/src/engine/plan.ts +268 -0
- package/src/engine/rounding.ts +81 -0
- package/src/engine/types.ts +270 -0
- package/src/engine/validate.ts +222 -0
- package/src/http.ts +264 -0
- package/src/issuer/index.ts +9 -0
- package/src/issuer/port.ts +109 -0
- package/src/issuer/sidecar.ts +171 -0
- package/src/jobs.ts +115 -0
- package/src/manifest/index.ts +46 -0
- package/src/manifest/permissions.ts +28 -0
- package/src/manifest/server.ts +20 -0
- package/src/notifications.ts +120 -0
- package/src/sale/index.ts +8 -0
- package/src/sale/types.ts +292 -0
- package/src/sidecar/index.ts +9 -0
- package/src/sidecar/types.ts +243 -0
- package/tables/ibs-cbs-2026-11-13.json +156 -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
|
+
}
|