push.ts

/**
 * Writes a chunk to a writable stream.
 *
 * ```ts
 * import { push } from "./push.ts";
 *
 * const results: number[] = [];
 * const writer = new WritableStream<number>({
 *   write(chunk) {
 *     results.push(chunk);
 *   },
 * });
 *
 * await push(writer, 1);
 * await push(writer, 2);
 * await push(writer, 3);
 * console.log(results); // [1, 2, 3]
 * ```
 *
 * @template T The type of the chunk to write.
 * @param {WritableStream<T>} stream The stream to write to.
 * @param {T} value The chunk to write to the stream.
 * @returns {Promise<void>} A promise that resolves once the chunk has been written to the stream.
 */
export async function push<T>(
  stream: WritableStream<T>,
  value: T,
): Promise<void> {
  const writer = stream.getWriter();
  await writer.ready;
  await writer.write(value);
  writer.releaseLock();
}