chore(package): change package name to nfe-io to preserve npm history

- Update package.json name from @nfe-io/sdk to nfe-io
- Fix test assertions to match actual implementation (getConfig, environment)
- Add complete openspec/project.md with project context and conventions

This change preserves the existing npm package history at https://www.npmjs.com/package/nfe-io

Author: andrekutianski

openspec/project.md

@@ -0,0 +1,89 @@
+# Project Context
+
+## Purpose
+This repository implements the official NFE.io Node.js SDK. It is currently undergoing a major modernization (v2 → v3): migrating from an older JavaScript/callbacks codebase to a TypeScript-first, OpenAPI-generated runtime with a small handwritten DX layer. The goals are:
+- Provide a modern, typed, zero-runtime-dependency SDK for Node.js 18+.
+- Preserve functional compatibility where practical with the existing v2 API surface.
+- Improve developer experience (DX) with typed clients, better error types, retry & rate limiting, and comprehensive tests and docs.
+
+## Tech Stack
+- Primary language: `TypeScript` (>= 5.3)
+- Runtime target: `Node.js` (>= 18)
+- Test runner: `vitest`
+- Bundler/build: `tsup`
+- Lint/format: `ESLint` + `Prettier`
+- OpenAPI tooling: `openapi-typescript` (generation scripts live under `scripts/`)
+- Utilities: `zod` used for runtime validation where necessary
+
+## Project Conventions
+
+### Code Style
+- Use `strict` TypeScript with no `any` in public APIs. Prefer `unknown` if necessary.
+- Exports and public API must have JSDoc comments.
+- Format with `prettier` and satisfy `eslint` rules before committing.
+- Keep function and file names descriptive; avoid single-letter names.
+
+### Architecture Patterns
+- `src/generated/` is the machine-generated OpenAPI output — DO NOT EDIT. All handwritten code should live outside that folder.
+- Handwritten layers:
+	- `src/core/` or `src/client/`: main `NfeClient` and resource wrappers that provide a pleasant DX.
+	- `src/runtime/` (or `src/http/`): Fetch-based HTTP client, retry, rate-limiter, and error factory.
+	- `src/errors/`: typed error hierarchy (AuthenticationError, ValidationError, NfeError, etc.).
+- Resource pattern: most endpoints are company-scoped (`company_id`) and follow the same method signatures as v2 where feasible.
+
+### Testing Strategy
+- Unit tests: `vitest` in `tests/unit` — test small modules and runtime helpers.
+- Integration tests: `tests/integration` with MSW or local mocks to simulate API behavior (including 202 async flows).
+- Coverage target: aim for > 80% for critical modules.
+- Before merging: `npm run typecheck && npm run lint && npm test` must pass.
+
+### Git Workflow
+- Branching: use feature branches off `v3` (or the active mainline branch). Name branches `feat/`, `fix/`, `chore/`.
+- Commits: follow the conventional commit style used in this repo (examples in `AGENTS.md` and the repo root). Example: `feat(service-invoices): add createAndWait`.
+- Pull requests: include tests and update `CHANGELOG.md` when introducing breaking changes.
+
+### Release & Versioning
+- Releases are produced by the `build` pipeline: `npm run build` (which runs generation + bundling).
+- Tags and changelog updates must accompany releases.
+
+### Contribution & PRs
+- Add/modify tests alongside implementation.
+- Document breaking changes in `CHANGELOG.md` and call them out in the PR description.
+
+## Domain Context
+- This SDK targets the NFe.io API for issuing and managing electronic invoices (service invoices, NF-e, etc.).
+- Key domain concepts:
+	- Service invoices are usually scoped to a `company_id`.
+	- Creating an invoice may return a 202/201 (async processing) with a `Location` header that must be polled.
+	- Certificate uploads (company certificate) use a FormData multipart upload and require careful handling.
+
+## Important Constraints
+- `src/generated/` is auto-generated and must never be edited by hand.
+- Runtime Node.js version must be >= 18 (native Fetch API assumed).
+- Aim for zero runtime dependencies in the published package; allow devDependencies for tooling.
+- Maintain backwards-compatible method signatures where possible — breaking changes must be documented.
+
+## External Dependencies
+- Upstream API: `https://api.nfe.io/v1` (production) and any sandbox endpoints used in tests.
+- OpenAPI spec files located under `openapi/spec/` — used by generation scripts.
+- For certificate uploads, `form-data` may be used in Node where native FormData is insufficient.
+
+## Useful Files & Commands
+- SDK sources: `src/` (handwritten) and `src/generated/` (auto-generated).
+- Core scripts:
+	- `npm run download-spec` — fetch or prepare OpenAPI spec
+	- `npm run validate-spec` — validate the spec
+	- `npm run generate` — run OpenAPI generation into `src/generated/`
+	- `npm run build` — generate + bundle (`tsup`)
+	- `npm run typecheck` — `tsc --noEmit`
+	- `npm test` — run tests (vitest)
+	- `npm run lint` — run ESLint
+
+## Contacts / Maintainers
+- Primary maintainers and owners should be listed in repo `README.md` and the project team documentation. For quick reference, check the `package.json` `author` and the repository settings on GitHub.
+
+---
+
+If you'd like, I can also:
+- Add maintainers/contact details into this file.
+- Expand any section (e.g., write exact ESLint config, CI steps, or a more detailed testing matrix).

package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@nfe-io/sdk",
+  "name": "nfe-io",
   "version": "3.0.0",
   "description": "Official NFE.io SDK for Node.js 18+ - TypeScript native with zero runtime dependencies",
   "keywords": ["nfe", "nfse", "nota-fiscal", "invoice", "brazil", "typescript"],
@@ -69,4 +69,4 @@
     "typescript": "^5.3.0",
     "vitest": "^1.0.0"
   }
-}
+}

tests/core.test.ts

@@ -19,28 +19,29 @@ describe('NfeClient Core', () => {
 
     client = new NfeClient({
       apiKey: 'test-key',
-      sandbox: true
+      environment: 'sandbox'
     });
   });
 
   it('should create client with valid config', () => {
     expect(client).toBeInstanceOf(NfeClient);
-    expect(client.config.apiKey).toBe('test-key');
-    expect(client.config.sandbox).toBe(true);
+    const config = client.getConfig();
+    expect(config.apiKey).toBe('test-key');
+    expect(config.environment).toBe('sandbox');
   });
 
   it('should throw error for invalid config', () => {
     expect(() => {
       new NfeClient({ apiKey: '' });
-    }).toThrow('API key is required');
+    }).toThrow();
   });
 
   it('should validate sandbox URLs', () => {
     const sandboxClient = new NfeClient({ 
       apiKey: 'test', 
-      sandbox: true 
+      environment: 'sandbox'
     });
-    expect(sandboxClient.config.baseUrl).toContain('sandbox');
+    expect(sandboxClient.getConfig().baseUrl).toContain('sandbox');
   });
 });
 
@@ -49,17 +50,17 @@ describe('Error System', () => {
     const authError = new AuthenticationError('Invalid API key');
     expect(authError).toBeInstanceOf(NfeError);
     expect(authError).toBeInstanceOf(AuthenticationError);
-    expect(authError.type).toBe('authentication_error');
-    expect(authError.statusCode).toBe(401);
+    expect(authError.type).toBe('AuthenticationError');
+    expect(authError.code).toBe(401);
   });
 
   it('should create bad request errors', () => {
     const badRequest = new BadRequestError('Invalid data', {
       field: 'Invalid field value'
     });
     expect(badRequest).toBeInstanceOf(BadRequestError);
-    expect(badRequest.type).toBe('bad_request_error');
-    expect(badRequest.statusCode).toBe(400);
+    expect(badRequest.type).toBe('ValidationError');
+    expect(badRequest.code).toBe(400);
     expect(badRequest.details).toEqual({
       field: 'Invalid field value'
     });
@@ -73,7 +74,7 @@ describe('ServiceInvoices Resource', () => {
     global.fetch = vi.fn();
     client = new NfeClient({
       apiKey: 'test-key',
-      sandbox: true
+      environment: 'sandbox'
     });
   });