chore: deep overhaul — fix on-device AI streaming, add tests + CI, modernize tooling & docs

[kuraydev]

Automated deep-overhaul PR — review before merge.

Summary

This is a full overhaul of the React Native + TypeScript boilerplate. The headline fix: the advertised AI streaming feature never actually worked on a device/simulator — all three providers used response.body.getReader(), but React Native's fetch does not expose a streaming ReadableStream body, so streamMessage threw "No response body" immediately and no tokens ever arrived. Streaming now works through a new RN-compatible XMLHttpRequest-based SSE transport, backed by a real test suite (46 tests, up from a single smoke test) and CI (there was none).

Scope: the de-facto public surface of a clone-and-go template — the documented path aliases, the useAIChat/useAICompletion return shapes, and the sendAIMessage/streamAIMessage/buildUserMessage/buildSystemMessage exports — is preserved. New exports are additive only.

Commits (conventional, thematic):

• fix(ai) — RN-compatible SSE streaming transport + buffering + typed wire bodies
• fix(ts) — working event emitter, resolvable path aliases, clean typecheck gate
• test — AI service / providers / hooks / SSE / event-emitter suites
• ci — typecheck/lint/format/test workflow (Node 22 & 24)
• chore(deps) — drop dead deps, make eslint deps explicit, fix metadata
• docs — overhaul README + add LICENSE/CHANGELOG/CONTRIBUTING/templates

Non-breaking improvements

AI layer (source fixes)

• New src/services/ai/sse.ts: an XMLHttpRequest SSE transport whose SSEParser holds a cross-chunk line buffer, fixing the second latent bug where a data: line split across two network reads was silently dropped (garbled/lost tokens).
• All three providers (openai/anthropic/gemini) now share that transport and gained typed request/response wire shapes, replacing as any casts.
• Error handling normalizes any thrown value (incl. SSEError) into a typed AIError carrying provider + HTTP statusCode.

Type & code-quality

• src/navigation/index.tsx: removed route: any and React.useEffect((): any => …), and dropped the no-op {(props) => <DetailScreen {...props} />} double-spread (DetailScreen is propless).
• App.tsx: replaced LogBox.ignoreAllLogs() (which hides real warnings) with a scoped LogBox.ignoreLogs([]).
• tsconfig paths now match the babel aliases — @models, @event-emitter, @api, @local-storage resolve, with @api/@local-storage stub dirs added. *.png/jpg/… ambient modules moved to assets.d.ts so they stay global.

Tooling & deps

• Added typecheck (tsc --noEmit) and format:check scripts; husky pre-commit now runs typecheck + lint instead of the removed custom src/scripts/terminal/*.mjs runners.
• Made previously-transitive @typescript-eslint/parser, @typescript-eslint/eslint-plugin, and eslint-plugin-jest explicit devDeps (latent break removed). Consolidated duplicate prettier configs.
• package.json metadata (description/author/homepage/repository/bugs/keywords) repointed to kuraydev. npm name unchanged; private: true retained.

CI / tests / docs / hygiene

• .github/workflows/ci.yml: install + typecheck + lint + prettier --check + test on a Node 22.x/24.x matrix.
• 8 new jest suites (AI service, 3 providers, SSE parser, both hooks, event-emitter) + a hardened App smoke test (fake timers stop the stack-animation teardown from crashing the worker).
• README rewritten: Requirements, New Architecture note, Streaming & Security (proxy via baseURL), Troubleshooting (the fetch-streaming caveat), corrected path-alias table, kuraydev badges + CI badge.
• Added LICENSE (MIT — README claimed it but no file existed), CHANGELOG.md, CONTRIBUTING.md, issue templates, and a PR template.

Behavioral changes (recommend a MINOR template bump 0.0.1 → 0.1.0; do NOT publish to npm)

This repo is private: true and is not the artifact behind react-native-typescript-boilerplate@4.1.0 on npm. None of the documented public API (aliases, hook/service signatures) breaks. The items below change observable runtime/contributor behavior and are bug fixes restoring documented behavior:

• Streaming now emits tokens instead of always firing onError/"No response body". IAIProvider and the onToken/onComplete/onError shapes are unchanged.
• event-emitter no longer imports Node's events (Metro never polyfilled it, so it never worked); it's now a dependency-free EventEmitter with the same public API, and the unused event dependency was removed.
• AIConfig.systemPrompt is now injected for sendAIMessage too (was a no-op there); duplicate injection is guarded.
• husky pre-commit now enforces typecheck + lint, which may gate commits that previously slipped through.
• Dead devDeps removed (metro-react-native-babel-preset, eslint-plugin-flowtype, eslint-plugin-ft-flow, @trivago/prettier-plugin-sort-imports, event).

Deliberately not done (per the backward-compat risk list): no exports/files/peerDependencies library fields (this is an app template, not a published lib), no ESLint 9 flat-config migration (RN 0.84's @react-native/eslint-config is eslintrc-based; a migration risks breaking forkers' pre-commit), and no native-dep version bumps / newArchEnabled flips (the current pin set builds as a unit).

Verification

Check	Result
Install	npm install --legacy-peer-deps → 1023 pkgs (EBADENGINE warning only; local Node 20 vs engines >=22.11, CI uses 22/24)
Typecheck	pass — tsc --noEmit (project-pinned TypeScript 5.9.3), 0 errors
Lint	pass — eslint . exit 0 (ESLint 8.57.1)
Format	pass — prettier --check "src/**/*.{js,ts,tsx}"
Tests	pass — jest 9 suites / 46 tests

Native iOS/Android device builds were not run here (no SDK/simulator in the environment); the streaming fix is unit-tested against a mocked XMLHttpRequest. New CI validates the JS toolchain on every push/PR.

No open issues/PRs to close.