fix(codec): consumer-onboarding hardening for 0.1.0 first publish

packages/codec/package.json

@@ -43,6 +43,7 @@
     "voidpay",
     "void-layer"
   ],
+  "sideEffects": ["*.wasm", "pkg/**", "pkg-node/**"],
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -62,11 +63,13 @@
     "lint": "cargo clippy --all-targets --all-features --locked -- -D warnings && cargo fmt --manifest-path Cargo.toml -- --check && eslint src",
     "size": "ls -la pkg/void_layer_codec_bg.wasm"
   },
+  "dependencies": {
+    "@void-layer/types": "workspace:^"
+  },
   "peerDependencies": {
     "brotli-wasm": "^3.0.1"
   },
   "devDependencies": {
-    "@void-layer/types": "workspace:^",
     "@types/node": "25.9.1",
     "@vitest/coverage-v8": "4.1.8",
     "brotli-wasm": "^3.0.1",
@@ -76,6 +79,6 @@
     "vitest": "^4.1.8"
   },
   "engines": {
-    "node": ">=24"
+    "node": ">=20"
   }
 }

packages/codec/src/index.test.ts

@@ -156,11 +156,11 @@ describe('decodeInvoiceWire decompression-bomb guard', () => {
 })
 
 // ---------------------------------------------------------------------------
-// G-11 T5: write_quantity rejects > 9 significant decimals (PrecisionLoss).
-// T5 changed silent clamp → explicit CodecError::PrecisionLoss throw.
+// G-11 T5: write_quantity rejects > 9 significant decimals (InvalidAmount).
+// T5 changed silent clamp → explicit CodecError::InvalidAmount throw.
 // ---------------------------------------------------------------------------
 
-describe('G-11: write_quantity PrecisionLoss on >9 decimals (T5)', () => {
+describe('G-11: write_quantity InvalidAmount on >9 decimals (T5)', () => {
   it('G-11: write_quantity rejects > 9 significant decimals (T5)', () => {
     const inv: Invoice = {
       ...MINIMAL_INVOICE,

packages/codec/src/index.ts

@@ -15,15 +15,20 @@ import type { BrotliWasmType } from 'brotli-wasm'
 import type { Invoice } from '@void-layer/types'
 import { encodeWire, decodeWire } from './wire.js'
 
-// Import the canonical WASM functions for use in the wire shim below, and
-// re-export them as part of the public API.
-import {
-  encodeInvoiceCanonical,
-  decodeInvoiceCanonical,
-  receiptHash,
-} from '../pkg/void_layer_codec.js'
-
-export { encodeInvoiceCanonical, decodeInvoiceCanonical, receiptHash }
+// Import the canonical WASM module and cast to a typed surface so that
+// consumers get proper Invoice types (not `any`) in the generated .d.ts.
+// Runtime behaviour is unchanged — these are the same WASM functions.
+import * as _wasmPkg from '../pkg/void_layer_codec.js'
+
+const _wasm = _wasmPkg as unknown as {
+  encodeInvoiceCanonical: (invoice: Invoice) => Uint8Array
+  decodeInvoiceCanonical: (bytes: Uint8Array) => Invoice
+  receiptHash: (canonical_bytes: Uint8Array) => Uint8Array
+}
+
+export const encodeInvoiceCanonical = _wasm.encodeInvoiceCanonical
+export const decodeInvoiceCanonical = _wasm.decodeInvoiceCanonical
+export const receiptHash = _wasm.receiptHash
 
 // ---------------------------------------------------------------------------
 // Brotli lazy init (mirrors compressPayload reference pattern)

packages/networks/package.json

@@ -23,9 +23,10 @@
   "homepage": "https://github.com/void-layer/codec/tree/main/packages/networks#readme",
   "bugs": { "url": "https://github.com/void-layer/codec/issues" },
   "keywords": ["voidpay","void-layer","ethereum","chains","tokens","web3"],
+  "sideEffects": false,
   "publishConfig": { "access": "public", "provenance": true },
   "dependencies": {
-    "@void-layer/types": "workspace:*"
+    "@void-layer/types": "workspace:^"
   },
   "peerDependencies": {
     "viem": ">=2.0.0 <3.0.0"

packages/networks/tsconfig.json

@@ -14,10 +14,11 @@
     "skipLibCheck": true
   },
   "include": [
-    "src/**/*"
+    "src/**/*.ts"
   ],
   "exclude": [
     "node_modules",
-    "dist"
+    "dist",
+    "src/**/*.test.ts"
   ]
 }

packages/types/tsconfig.json

@@ -15,5 +15,5 @@
     "noUncheckedIndexedAccess": true
   },
   "include": ["src/**/*.ts"],
-  "exclude": ["dist", "node_modules"]
+  "exclude": ["dist", "node_modules", "src/**/*.test.ts"]
 }