fix(package.json): correct broken "types" path so TS consumers get types

[Dvir Arad (dvirarad)]

Summary

Fixes #403.

package.json advertises

"types": "types/index.d.ts"

but that file does not exist in the published package or in the repo. The actual type entry is the top-level index.d.ts, which re-exports the per-module declarations:

// index.d.ts (repo root)
export * from './types/rdkafka';
export * as RdKafka from './types/rdkafka';
export * as KafkaJS from './types/kafkajs';

Impact

With the current types path pointing at a non-existent file, TypeScript consumers of @confluentinc/kafka-javascript get no types at all when they import { ... } from '@confluentinc/kafka-javascript' — they see any everywhere. Workarounds in the wild include "paths" shims or direct deep imports from node_modules/.../types/rdkafka, neither of which should be necessary. Maintainer Pratyush Ranjan (@PratRanj07) acknowledged the bug in #403 (internal ticket 4253).

Verification

On master today (2026-05-11):

curl -sI https://raw.githubusercontent.com/confluentinc/confluent-kafka-javascript/master/types/index.d.ts  → 404
curl -sI https://raw.githubusercontent.com/confluentinc/confluent-kafka-javascript/master/index.d.ts        → 200

The types/ directory exists and contains config.d.ts, errors.d.ts, kafkajs.d.ts, rdkafka.d.ts, etc., but there is no index.d.ts inside it. The only index.d.ts in the repo is at the root.

Fix

One-line change in package.json:

-  "types": "types/index.d.ts",
+  "types": "index.d.ts",

index.d.ts is already shipped (it lives at the repo root and is not in .gitignore / files-excluded), so no other changes are needed. After this fix, tsc resolves @confluentinc/kafka-javascript to the existing root index.d.ts and downstream users get the full RdKafka / KafkaJS types.

Test plan

• curl confirms index.d.ts exists and types/index.d.ts 404s on master
• npm pack --dry-run (locally) shows index.d.ts is included in the tarball alongside types/*.d.ts
• test:types script (tsc -p .) still passes (no source change — only the manifest pointer moved)
• CI green

Happy to add a small consumer smoke-test (tsc --noEmit against a tiny import { KafkaJS } from '@confluentinc/kafka-javascript' stub) if maintainers want a regression guard.

[Copilot]

Pull request overview

This PR fixes TypeScript type resolution for @confluentinc/kafka-javascript by correcting the package.json types entry to point at the existing root index.d.ts (instead of the non-existent types/index.d.ts), addressing #403.

Changes:

• Update package.json "types" field from types/index.d.ts to index.d.ts.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.