feat(batch): add typed BatchPartiallySubmittedError (closes #601)

[Ranjeet2063]

Summary

Adds a typed BatchPartiallySubmittedError carrying firstFailureIndex, skippedIndices, and outcomes, allowing callers to catch and inspect mid-batch failures without manually parsing the outcomes array, and provides the { throwOnPartial: true } option in submitBatch (closes #601).

Key Changes

• src/errors.ts:
  • Implemented BatchPartiallySubmittedError extending Error with firstFailureIndex, skippedIndices, and outcomes.
  • Added BatchPartiallySubmittedError to isConduitError type guard.
• src/batch-tx.ts:
  • Added throwOnPartial?: boolean to BatchSubmitOptions.
  • Updated submitBatch to throw BatchPartiallySubmittedError when options.throwOnPartial is true and a failure occurs.
  • Re-exported BatchPartiallySubmittedError.
• src/index.ts:
  • Re-exported BatchPartiallySubmittedError.
• src/tests/batch-submit.test.ts:
  • Added tests for BatchPartiallySubmittedError when throwOnPartial is enabled, and verified standard return behavior when omitted.

Verification

• vitest run src/tests/batch-submit.test.ts: 21/21 tests passing.
• Clean build with npm run build.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.