@langchain/google-common 0.2.17 → 1.0.0

package/dist/utils/stream.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.cjs","names":["value: unknown","ret: Record<string, unknown>","v: Record<string, any>","val: unknown","data: string","start: string","ret: object | null","obj: unknown","chunk: any","baseStream: AbstractStream","body: ReadableStream | null","body: any","event: string | null","ret: Record<string, string>","jsonAttribute?: string"],"sources":["../../src/utils/stream.ts"],"sourcesContent":["import { GenerationChunk } from \"@langchain/core/outputs\";\n\nexport interface AbstractStream {\n  /**\n   * Add more text to the buffer\n   * @param data\n   */\n  appendBuffer(data: string): void;\n\n  /**\n   * Indicate that there is no more text to be added to the buffer\n   * (ie - our source material is done)\n   */\n  closeBuffer(): void;\n  /**\n   * Get the next chunk that is coming from the stream.\n   * This chunk may be null, usually indicating the last chunk in the stream.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  nextChunk(): Promise<any>;\n\n  /**\n   * Is the stream done?\n   * A stream is only done if all of the following are true:\n   * - There is no more data to be added to the text buffer\n   * - There is no more data in the text buffer\n   * - There are no chunks that are waiting to be consumed\n   */\n  get streamDone(): boolean;\n}\n\nexport function complexValue(value: unknown): unknown {\n  if (value === null || typeof value === \"undefined\") {\n    // I dunno what to put here. An error, probably\n    return undefined;\n  } else if (typeof value === \"object\") {\n    if (Array.isArray(value)) {\n      return {\n        list_val: value.map((avalue) => complexValue(avalue)),\n      };\n    } else {\n      const ret: Record<string, unknown> = {};\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const v: Record<string, any> = value;\n      Object.keys(v).forEach((key) => {\n        ret[key] = complexValue(v[key]);\n      });\n      return { struct_val: ret };\n    }\n  } else if (typeof value === \"number\") {\n    if (Number.isInteger(value)) {\n      return { int_val: value };\n    } else {\n      return { float_val: value };\n    }\n  } else {\n    return {\n      string_val: [value],\n    };\n  }\n}\n\nexport function simpleValue(val: unknown): unknown {\n  if (val && typeof val === \"object\" && !Array.isArray(val)) {\n    // eslint-disable-next-line no-prototype-builtins\n    if (val.hasOwnProperty(\"stringVal\")) {\n      return (val as { stringVal: string[] }).stringVal[0];\n\n      // eslint-disable-next-line no-prototype-builtins\n    } else if (val.hasOwnProperty(\"boolVal\")) {\n      return (val as { boolVal: boolean[] }).boolVal[0];\n\n      // eslint-disable-next-line no-prototype-builtins\n    } else if (val.hasOwnProperty(\"listVal\")) {\n      const { listVal } = val as { listVal: unknown[] };\n      return listVal.map((aval) => simpleValue(aval));\n\n      // eslint-disable-next-line no-prototype-builtins\n    } else if (val.hasOwnProperty(\"structVal\")) {\n      const ret: Record<string, unknown> = {};\n      const struct = (val as { structVal: Record<string, unknown> }).structVal;\n      Object.keys(struct).forEach((key) => {\n        ret[key] = simpleValue(struct[key]);\n      });\n      return ret;\n    } else {\n      const ret: Record<string, unknown> = {};\n      const struct = val as Record<string, unknown>;\n      Object.keys(struct).forEach((key) => {\n        ret[key] = simpleValue(struct[key]);\n      });\n      return ret;\n    }\n  } else if (Array.isArray(val)) {\n    return val.map((aval) => simpleValue(aval));\n  } else {\n    return val;\n  }\n}\nexport class JsonStream implements AbstractStream {\n  _buffer = \"\";\n\n  _bufferOpen = true;\n\n  _firstRun = true;\n\n  /**\n   * Add data to the buffer. This may cause chunks to be generated, if available.\n   * @param data\n   */\n  appendBuffer(data: string): void {\n    this._buffer += data;\n    // Our first time, skip to the opening of the array\n    if (this._firstRun) {\n      this._skipTo(\"[\");\n      this._firstRun = false;\n    }\n\n    this._parseBuffer();\n  }\n\n  /**\n   * Indicate there is no more data that will be added to the text buffer.\n   * This should be called when all the data has been read and added to indicate\n   * that we should process everything remaining in the buffer.\n   */\n  closeBuffer(): void {\n    this._bufferOpen = false;\n    this._parseBuffer();\n  }\n\n  /**\n   * Skip characters in the buffer till we get to the start of an object.\n   * Then attempt to read a full object.\n   * If we do read a full object, turn it into a chunk and send it to the chunk handler.\n   * Repeat this for as much as we can.\n   */\n  _parseBuffer(): void {\n    let obj = null;\n    do {\n      this._skipTo(\"{\");\n      obj = this._getFullObject();\n      if (obj !== null) {\n        const chunk = this._simplifyObject(obj);\n        this._handleChunk(chunk);\n      }\n    } while (obj !== null);\n\n    if (!this._bufferOpen) {\n      // No more data will be added, and we have parsed everything we could,\n      // so everything else is garbage.\n      this._handleChunk(null);\n      this._buffer = \"\";\n    }\n  }\n\n  /**\n   * If the string is present, move the start of the buffer to the first occurrence\n   * of that string. This is useful for skipping over elements or parts that we're not\n   * really interested in parsing. (ie - the opening characters, comma separators, etc.)\n   * @param start The string to start the buffer with\n   */\n  _skipTo(start: string): void {\n    const index = this._buffer.indexOf(start);\n    if (index > 0) {\n      this._buffer = this._buffer.slice(index);\n    }\n  }\n\n  /**\n   * Given what is in the buffer, parse a single object out of it.\n   * If a complete object isn't available, return null.\n   * Assumes that we are at the start of an object to parse.\n   */\n  _getFullObject(): object | null {\n    let ret: object | null = null;\n\n    // Loop while we don't have something to return AND we have something in the buffer\n    let index = 0;\n    while (ret === null && this._buffer.length > index) {\n      // Advance to the next close bracket after our current index\n      index = this._buffer.indexOf(\"}\", index + 1);\n\n      // If we don't find one, exit with null\n      if (index === -1) {\n        return null;\n      }\n\n      // If we have one, try to turn it into an object to return\n      try {\n        const objStr = this._buffer.substring(0, index + 1);\n        ret = JSON.parse(objStr);\n\n        // We only get here if it parsed it ok\n        // If we did turn it into an object, remove it from the buffer\n        this._buffer = this._buffer.slice(index + 1);\n      } catch {\n        // It didn't parse it correctly, so we swallow the exception and continue\n      }\n    }\n\n    return ret;\n  }\n\n  _simplifyObject(obj: unknown): object {\n    return obj as object;\n  }\n\n  // Set up a potential Promise that the handler can resolve.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  _chunkResolution: (chunk: any) => void;\n\n  // If there is no Promise (it is null), the handler must add it to the queue\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  _chunkPending: Promise<any> | null = null;\n\n  // A queue that will collect chunks while there is no Promise\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  _chunkQueue: any[] = [];\n\n  /**\n   * Register that we have another chunk available for consumption.\n   * If we are waiting for a chunk, resolve the promise waiting for it immediately.\n   * If not, then add it to the queue.\n   * @param chunk\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  _handleChunk(chunk: any): void {\n    if (this._chunkPending) {\n      this._chunkResolution(chunk);\n      this._chunkPending = null;\n    } else {\n      this._chunkQueue.push(chunk);\n    }\n  }\n\n  /**\n   * Get the next chunk that is coming from the stream.\n   * This chunk may be null, usually indicating the last chunk in the stream.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async nextChunk(): Promise<any> {\n    if (this._chunkQueue.length > 0) {\n      // If there is data in the queue, return the next queue chunk\n      return this._chunkQueue.shift() as GenerationChunk;\n    } else {\n      // Otherwise, set up a promise that handleChunk will cause to be resolved\n      this._chunkPending = new Promise((resolve) => {\n        this._chunkResolution = resolve;\n      });\n      return this._chunkPending;\n    }\n  }\n\n  /**\n   * Is the stream done?\n   * A stream is only done if all of the following are true:\n   * - There is no more data to be added to the text buffer\n   * - There is no more data in the text buffer\n   * - There are no chunks that are waiting to be consumed\n   */\n  get streamDone(): boolean {\n    return (\n      !this._bufferOpen &&\n      this._buffer.length === 0 &&\n      this._chunkQueue.length === 0 &&\n      this._chunkPending === null\n    );\n  }\n}\n\nexport class ComplexJsonStream extends JsonStream {\n  _simplifyObject(obj: unknown): object {\n    return simpleValue(obj) as object;\n  }\n}\n\nexport class ReadableAbstractStream implements AbstractStream {\n  private baseStream: AbstractStream;\n\n  decoder: TextDecoder;\n\n  constructor(baseStream: AbstractStream, body: ReadableStream | null) {\n    this.baseStream = baseStream;\n    this.decoder = new TextDecoder(\"utf-8\");\n    if (body) {\n      // eslint-disable-next-line no-void\n      void this.run(body);\n    } else {\n      console.error(\"Unexpected empty body while streaming\");\n    }\n  }\n\n  appendBuffer(data: string): void {\n    return this.baseStream.appendBuffer(data);\n  }\n\n  closeBuffer(): void {\n    return this.baseStream.closeBuffer();\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  nextChunk(): Promise<any> {\n    return this.baseStream.nextChunk();\n  }\n\n  get streamDone(): boolean {\n    return this.baseStream.streamDone;\n  }\n\n  // Should be a ReadableStream, but the Gaxios Readable stream isn't.\n  // But both should support async iterators, so make sure of that.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async run(body: any) {\n    if (typeof body[Symbol.asyncIterator] === \"function\") {\n      for await (const value of body) {\n        const svalue = this.decoder.decode(value, { stream: true });\n        this.appendBuffer(svalue);\n      }\n      this.closeBuffer();\n    } else {\n      throw Error(\"Stream must implement async iterator.\");\n    }\n  }\n}\n\nexport class ReadableJsonStream extends ReadableAbstractStream {\n  constructor(body: ReadableStream | null) {\n    super(new JsonStream(), body);\n  }\n}\n\nexport class SseStream implements AbstractStream {\n  _buffer = \"\";\n\n  _bufferOpen = true;\n\n  appendBuffer(data: string): void {\n    this._buffer += data;\n    this._parseBuffer();\n  }\n\n  closeBuffer(): void {\n    this._bufferOpen = false;\n    this._parseBuffer();\n  }\n\n  /**\n   * Attempt to load an entire event.\n   * For each entire event we load,\n   * send them to be handled.\n   */\n  _parseBuffer(): void {\n    const events = this._buffer.split(/\\n\\n/);\n    this._buffer = events.pop() ?? \"\";\n    events.forEach((event) => this._handleEvent(event.trim()));\n\n    if (!this._bufferOpen) {\n      // No more data will be added, and we have parsed\n      // everything. So dump the rest.\n      this._handleEvent(null);\n      this._buffer = \"\";\n    }\n  }\n\n  /**\n   * Given an event string, get all the fields\n   * in the event. It is assumed there is one field\n   * per line, but that field names can be duplicated,\n   * indicating to append the new value to the previous value\n   * @param event\n   */\n  _parseEvent(event: string | null): Record<string, string> | null {\n    if (!event || event.trim() === \"\") {\n      return null;\n    }\n    const ret: Record<string, string> = {};\n\n    const lines = event.split(/\\n/);\n    lines.forEach((line) => {\n      const match = line.match(/^([^:]+): \\s*(.+)\\n*$/);\n      if (match && match.length === 3) {\n        const key = match[1];\n        const val = match[2];\n        const cur = ret[key] ?? \"\";\n        ret[key] = `${cur}${val}`;\n      }\n    });\n\n    return ret;\n  }\n\n  // Set up a potential Promise that the handler can resolve.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  _chunkResolution: (chunk: any) => void;\n\n  // If there is no Promise (it is null), the handler must add it to the queue\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  _chunkPending: Promise<any> | null = null;\n\n  // A queue that will collect chunks while there is no Promise\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  _chunkQueue: any[] = [];\n\n  _handleEvent(event: string | null): void {\n    const chunk = this._parseEvent(event);\n    if (this._chunkPending) {\n      this._chunkResolution(chunk);\n      this._chunkPending = null;\n    } else {\n      this._chunkQueue.push(chunk);\n    }\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async nextChunk(): Promise<any> {\n    if (this._chunkQueue.length > 0) {\n      // If there is data in the queue, return the next queue chunk\n      return this._chunkQueue.shift() as Record<string, string>;\n    } else {\n      // Otherwise, set up a promise that handleChunk will cause to be resolved\n      this._chunkPending = new Promise((resolve) => {\n        this._chunkResolution = resolve;\n      });\n      return this._chunkPending;\n    }\n  }\n\n  get streamDone(): boolean {\n    return (\n      !this._bufferOpen &&\n      this._buffer.length === 0 &&\n      this._chunkQueue.length === 0 &&\n      this._chunkPending === null\n    );\n  }\n}\n\nexport class ReadableSseStream extends ReadableAbstractStream {\n  constructor(body: ReadableStream | null) {\n    super(new SseStream(), body);\n  }\n}\n\nexport class SseJsonStream extends SseStream {\n  _jsonAttribute: string = \"data\";\n\n  constructor(jsonAttribute?: string) {\n    super();\n    this._jsonAttribute = jsonAttribute ?? this._jsonAttribute;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async nextChunk(): Promise<any> {\n    const eventRecord = (await super.nextChunk()) as Record<string, string>;\n    const json = eventRecord?.[this._jsonAttribute];\n    if (!json) {\n      return null;\n    } else {\n      return JSON.parse(json);\n    }\n  }\n}\n\nexport class ReadableSseJsonStream extends ReadableAbstractStream {\n  constructor(body: ReadableStream | null) {\n    super(new SseJsonStream(), body);\n  }\n}\n"],"mappings":"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"}

package/dist/utils/stream.d.cts

@@ -0,0 +1,165 @@
+//#region src/utils/stream.d.ts
+interface AbstractStream {
+  /**
+   * Add more text to the buffer
+   * @param data
+   */
+  appendBuffer(data: string): void;
+  /**
+   * Indicate that there is no more text to be added to the buffer
+   * (ie - our source material is done)
+   */
+  closeBuffer(): void;
+  /**
+   * Get the next chunk that is coming from the stream.
+   * This chunk may be null, usually indicating the last chunk in the stream.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  nextChunk(): Promise<any>;
+  /**
+   * Is the stream done?
+   * A stream is only done if all of the following are true:
+   * - There is no more data to be added to the text buffer
+   * - There is no more data in the text buffer
+   * - There are no chunks that are waiting to be consumed
+   */
+  get streamDone(): boolean;
+}
+declare function complexValue(value: unknown): unknown;
+declare function simpleValue(val: unknown): unknown;
+declare class JsonStream implements AbstractStream {
+  _buffer: string;
+  _bufferOpen: boolean;
+  _firstRun: boolean;
+  /**
+   * Add data to the buffer. This may cause chunks to be generated, if available.
+   * @param data
+   */
+  appendBuffer(data: string): void;
+  /**
+   * Indicate there is no more data that will be added to the text buffer.
+   * This should be called when all the data has been read and added to indicate
+   * that we should process everything remaining in the buffer.
+   */
+  closeBuffer(): void;
+  /**
+   * Skip characters in the buffer till we get to the start of an object.
+   * Then attempt to read a full object.
+   * If we do read a full object, turn it into a chunk and send it to the chunk handler.
+   * Repeat this for as much as we can.
+   */
+  _parseBuffer(): void;
+  /**
+   * If the string is present, move the start of the buffer to the first occurrence
+   * of that string. This is useful for skipping over elements or parts that we're not
+   * really interested in parsing. (ie - the opening characters, comma separators, etc.)
+   * @param start The string to start the buffer with
+   */
+  _skipTo(start: string): void;
+  /**
+   * Given what is in the buffer, parse a single object out of it.
+   * If a complete object isn't available, return null.
+   * Assumes that we are at the start of an object to parse.
+   */
+  _getFullObject(): object | null;
+  _simplifyObject(obj: unknown): object;
+  // Set up a potential Promise that the handler can resolve.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _chunkResolution: (chunk: any) => void;
+  // If there is no Promise (it is null), the handler must add it to the queue
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _chunkPending: Promise<any> | null;
+  // A queue that will collect chunks while there is no Promise
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _chunkQueue: any[];
+  /**
+   * Register that we have another chunk available for consumption.
+   * If we are waiting for a chunk, resolve the promise waiting for it immediately.
+   * If not, then add it to the queue.
+   * @param chunk
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _handleChunk(chunk: any): void;
+  /**
+   * Get the next chunk that is coming from the stream.
+   * This chunk may be null, usually indicating the last chunk in the stream.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  nextChunk(): Promise<any>;
+  /**
+   * Is the stream done?
+   * A stream is only done if all of the following are true:
+   * - There is no more data to be added to the text buffer
+   * - There is no more data in the text buffer
+   * - There are no chunks that are waiting to be consumed
+   */
+  get streamDone(): boolean;
+}
+declare class ComplexJsonStream extends JsonStream {
+  _simplifyObject(obj: unknown): object;
+}
+declare class ReadableAbstractStream implements AbstractStream {
+  private baseStream;
+  decoder: TextDecoder;
+  constructor(baseStream: AbstractStream, body: ReadableStream | null);
+  appendBuffer(data: string): void;
+  closeBuffer(): void;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  nextChunk(): Promise<any>;
+  get streamDone(): boolean;
+  // Should be a ReadableStream, but the Gaxios Readable stream isn't.
+  // But both should support async iterators, so make sure of that.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  run(body: any): Promise<void>;
+}
+declare class ReadableJsonStream extends ReadableAbstractStream {
+  constructor(body: ReadableStream | null);
+}
+declare class SseStream implements AbstractStream {
+  _buffer: string;
+  _bufferOpen: boolean;
+  appendBuffer(data: string): void;
+  closeBuffer(): void;
+  /**
+   * Attempt to load an entire event.
+   * For each entire event we load,
+   * send them to be handled.
+   */
+  _parseBuffer(): void;
+  /**
+   * Given an event string, get all the fields
+   * in the event. It is assumed there is one field
+   * per line, but that field names can be duplicated,
+   * indicating to append the new value to the previous value
+   * @param event
+   */
+  _parseEvent(event: string | null): Record<string, string> | null;
+  // Set up a potential Promise that the handler can resolve.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _chunkResolution: (chunk: any) => void;
+  // If there is no Promise (it is null), the handler must add it to the queue
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _chunkPending: Promise<any> | null;
+  // A queue that will collect chunks while there is no Promise
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _chunkQueue: any[];
+  _handleEvent(event: string | null): void;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  nextChunk(): Promise<any>;
+  get streamDone(): boolean;
+}
+declare class ReadableSseStream extends ReadableAbstractStream {
+  constructor(body: ReadableStream | null);
+}
+declare class SseJsonStream extends SseStream {
+  _jsonAttribute: string;
+  constructor(jsonAttribute?: string);
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  nextChunk(): Promise<any>;
+}
+declare class ReadableSseJsonStream extends ReadableAbstractStream {
+  constructor(body: ReadableStream | null);
+}
+//#endregion
+export { AbstractStream, ComplexJsonStream, JsonStream, ReadableAbstractStream, ReadableJsonStream, ReadableSseJsonStream, ReadableSseStream, SseJsonStream, SseStream, complexValue, simpleValue };
+//# sourceMappingURL=stream.d.cts.map

package/dist/utils/stream.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.cts","names":["AbstractStream","Promise","complexValue","simpleValue","JsonStream","ComplexJsonStream","ReadableAbstractStream","TextDecoder","ReadableStream","ReadableJsonStream","SseStream","Record","ReadableSseStream","SseJsonStream","ReadableSseJsonStream"],"sources":["../../src/utils/stream.d.ts"],"sourcesContent":["export interface AbstractStream {\n    /**\n     * Add more text to the buffer\n     * @param data\n     */\n    appendBuffer(data: string): void;\n    /**\n     * Indicate that there is no more text to be added to the buffer\n     * (ie - our source material is done)\n     */\n    closeBuffer(): void;\n    /**\n     * Get the next chunk that is coming from the stream.\n     * This chunk may be null, usually indicating the last chunk in the stream.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nextChunk(): Promise<any>;\n    /**\n     * Is the stream done?\n     * A stream is only done if all of the following are true:\n     * - There is no more data to be added to the text buffer\n     * - There is no more data in the text buffer\n     * - There are no chunks that are waiting to be consumed\n     */\n    get streamDone(): boolean;\n}\nexport declare function complexValue(value: unknown): unknown;\nexport declare function simpleValue(val: unknown): unknown;\nexport declare class JsonStream implements AbstractStream {\n    _buffer: string;\n    _bufferOpen: boolean;\n    _firstRun: boolean;\n    /**\n     * Add data to the buffer. This may cause chunks to be generated, if available.\n     * @param data\n     */\n    appendBuffer(data: string): void;\n    /**\n     * Indicate there is no more data that will be added to the text buffer.\n     * This should be called when all the data has been read and added to indicate\n     * that we should process everything remaining in the buffer.\n     */\n    closeBuffer(): void;\n    /**\n     * Skip characters in the buffer till we get to the start of an object.\n     * Then attempt to read a full object.\n     * If we do read a full object, turn it into a chunk and send it to the chunk handler.\n     * Repeat this for as much as we can.\n     */\n    _parseBuffer(): void;\n    /**\n     * If the string is present, move the start of the buffer to the first occurrence\n     * of that string. This is useful for skipping over elements or parts that we're not\n     * really interested in parsing. (ie - the opening characters, comma separators, etc.)\n     * @param start The string to start the buffer with\n     */\n    _skipTo(start: string): void;\n    /**\n     * Given what is in the buffer, parse a single object out of it.\n     * If a complete object isn't available, return null.\n     * Assumes that we are at the start of an object to parse.\n     */\n    _getFullObject(): object | null;\n    _simplifyObject(obj: unknown): object;\n    // Set up a potential Promise that the handler can resolve.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _chunkResolution: (chunk: any) => void;\n    // If there is no Promise (it is null), the handler must add it to the queue\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _chunkPending: Promise<any> | null;\n    // A queue that will collect chunks while there is no Promise\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _chunkQueue: any[];\n    /**\n     * Register that we have another chunk available for consumption.\n     * If we are waiting for a chunk, resolve the promise waiting for it immediately.\n     * If not, then add it to the queue.\n     * @param chunk\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _handleChunk(chunk: any): void;\n    /**\n     * Get the next chunk that is coming from the stream.\n     * This chunk may be null, usually indicating the last chunk in the stream.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nextChunk(): Promise<any>;\n    /**\n     * Is the stream done?\n     * A stream is only done if all of the following are true:\n     * - There is no more data to be added to the text buffer\n     * - There is no more data in the text buffer\n     * - There are no chunks that are waiting to be consumed\n     */\n    get streamDone(): boolean;\n}\nexport declare class ComplexJsonStream extends JsonStream {\n    _simplifyObject(obj: unknown): object;\n}\nexport declare class ReadableAbstractStream implements AbstractStream {\n    private baseStream;\n    decoder: TextDecoder;\n    constructor(baseStream: AbstractStream, body: ReadableStream | null);\n    appendBuffer(data: string): void;\n    closeBuffer(): void;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nextChunk(): Promise<any>;\n    get streamDone(): boolean;\n    // Should be a ReadableStream, but the Gaxios Readable stream isn't.\n    // But both should support async iterators, so make sure of that.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    run(body: any): Promise<void>;\n}\nexport declare class ReadableJsonStream extends ReadableAbstractStream {\n    constructor(body: ReadableStream | null);\n}\nexport declare class SseStream implements AbstractStream {\n    _buffer: string;\n    _bufferOpen: boolean;\n    appendBuffer(data: string): void;\n    closeBuffer(): void;\n    /**\n     * Attempt to load an entire event.\n     * For each entire event we load,\n     * send them to be handled.\n     */\n    _parseBuffer(): void;\n    /**\n     * Given an event string, get all the fields\n     * in the event. It is assumed there is one field\n     * per line, but that field names can be duplicated,\n     * indicating to append the new value to the previous value\n     * @param event\n     */\n    _parseEvent(event: string | null): Record<string, string> | null;\n    // Set up a potential Promise that the handler can resolve.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _chunkResolution: (chunk: any) => void;\n    // If there is no Promise (it is null), the handler must add it to the queue\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _chunkPending: Promise<any> | null;\n    // A queue that will collect chunks while there is no Promise\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _chunkQueue: any[];\n    _handleEvent(event: string | null): void;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nextChunk(): Promise<any>;\n    get streamDone(): boolean;\n}\nexport declare class ReadableSseStream extends ReadableAbstractStream {\n    constructor(body: ReadableStream | null);\n}\nexport declare class SseJsonStream extends SseStream {\n    _jsonAttribute: string;\n    constructor(jsonAttribute?: string);\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nextChunk(): Promise<any>;\n}\nexport declare class ReadableSseJsonStream extends ReadableAbstractStream {\n    constructor(body: ReadableStream | null);\n}\n"],"mappings":";UAAiBA,cAAAA;EAAAA;AA0BjB;AACA;AACA;EAA+B,YAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAA;;;AAA0B;EAoEpCK,WAAAA,EAAAA,EAAAA,IAAAA;EAGAC;;;;EAGqB;EAAsB,SAI/CL,EAAAA,EA1FAA,OA0FAA,CAAAA,GAAAA,CAAAA;EAAO;;AAP6C;AAcrE;;;;EAAsE,IAAA,UAAA,EAAA,EAAA,OAAA;AAGtE;AAA8B,iBA1FNC,YAAAA,CA0FM,KAAA,EAAA,OAAA,CAAA,EAAA,OAAA;AAkBSS,iBA3GfR,WAAAA,CA2GeQ,GAAAA,EAAAA,OAAAA,CAAAA,EAAAA,OAAAA;AAMpBV,cAhHEG,UAAAA,YAAsBJ,cAgHxBC,CAAAA;EAAO,OAMTA,EAAAA,MAAAA;EAAO,WA9BkBD,EAAAA,OAAAA;EAAc,SAAA,EAAA,OAAA;EAiCnCY;;;;EAAgD,YAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAGhDC;;;;AAA+B;EAM/BC,WAAAA,CAAAA,CAAAA,EAAAA,IAAAA;EAAqB;;;AAA+B;;;;;;;;;;;;;;;;;;;;;;;iBAzFtDb;;;;;;;;;;;;;;;;;eAiBFA;;;;;;;;;;cAUII,iBAAAA,SAA0BD,UAAU;;;cAGpCE,sBAAAA,YAAkCN;;WAE1CO;0BACeP,sBAAsBQ;;;;eAIjCP;;;;;kBAKGA;;cAECQ,kBAAAA,SAA2BH,sBAAAA;oBAC1BE;;cAEDE,SAAAA,YAAqBV;;;;;;;;;;;;;;;;;;qCAkBHW;;;;;;iBAMpBV;;;;;;eAMFA;;;cAGIW,iBAAAA,SAA0BN,sBAAAA;oBACzBE;;cAEDK,aAAAA,SAAsBH,SAAAA;;;;eAI1BT;;cAEIa,qBAAAA,SAA8BR,sBAAAA;oBAC7BE"}

package/dist/utils/stream.d.ts

@@ -1,140 +1,165 @@
-export interface AbstractStream {
-    /**
-     * Add more text to the buffer
-     * @param data
-     */
-    appendBuffer(data: string): void;
-    /**
-     * Indicate that there is no more text to be added to the buffer
-     * (ie - our source material is done)
-     */
-    closeBuffer(): void;
-    /**
-     * Get the next chunk that is coming from the stream.
-     * This chunk may be null, usually indicating the last chunk in the stream.
-     */
-    nextChunk(): Promise<any>;
-    /**
-     * Is the stream done?
-     * A stream is only done if all of the following are true:
-     * - There is no more data to be added to the text buffer
-     * - There is no more data in the text buffer
-     * - There are no chunks that are waiting to be consumed
-     */
-    get streamDone(): boolean;
+//#region src/utils/stream.d.ts
+interface AbstractStream {
+  /**
+   * Add more text to the buffer
+   * @param data
+   */
+  appendBuffer(data: string): void;
+  /**
+   * Indicate that there is no more text to be added to the buffer
+   * (ie - our source material is done)
+   */
+  closeBuffer(): void;
+  /**
+   * Get the next chunk that is coming from the stream.
+   * This chunk may be null, usually indicating the last chunk in the stream.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  nextChunk(): Promise<any>;
+  /**
+   * Is the stream done?
+   * A stream is only done if all of the following are true:
+   * - There is no more data to be added to the text buffer
+   * - There is no more data in the text buffer
+   * - There are no chunks that are waiting to be consumed
+   */
+  get streamDone(): boolean;
 }
-export declare function complexValue(value: unknown): unknown;
-export declare function simpleValue(val: unknown): unknown;
-export declare class JsonStream implements AbstractStream {
-    _buffer: string;
-    _bufferOpen: boolean;
-    _firstRun: boolean;
-    /**
-     * Add data to the buffer. This may cause chunks to be generated, if available.
-     * @param data
-     */
-    appendBuffer(data: string): void;
-    /**
-     * Indicate there is no more data that will be added to the text buffer.
-     * This should be called when all the data has been read and added to indicate
-     * that we should process everything remaining in the buffer.
-     */
-    closeBuffer(): void;
-    /**
-     * Skip characters in the buffer till we get to the start of an object.
-     * Then attempt to read a full object.
-     * If we do read a full object, turn it into a chunk and send it to the chunk handler.
-     * Repeat this for as much as we can.
-     */
-    _parseBuffer(): void;
-    /**
-     * If the string is present, move the start of the buffer to the first occurrence
-     * of that string. This is useful for skipping over elements or parts that we're not
-     * really interested in parsing. (ie - the opening characters, comma separators, etc.)
-     * @param start The string to start the buffer with
-     */
-    _skipTo(start: string): void;
-    /**
-     * Given what is in the buffer, parse a single object out of it.
-     * If a complete object isn't available, return null.
-     * Assumes that we are at the start of an object to parse.
-     */
-    _getFullObject(): object | null;
-    _simplifyObject(obj: unknown): object;
-    _chunkResolution: (chunk: any) => void;
-    _chunkPending: Promise<any> | null;
-    _chunkQueue: any[];
-    /**
-     * Register that we have another chunk available for consumption.
-     * If we are waiting for a chunk, resolve the promise waiting for it immediately.
-     * If not, then add it to the queue.
-     * @param chunk
-     */
-    _handleChunk(chunk: any): void;
-    /**
-     * Get the next chunk that is coming from the stream.
-     * This chunk may be null, usually indicating the last chunk in the stream.
-     */
-    nextChunk(): Promise<any>;
-    /**
-     * Is the stream done?
-     * A stream is only done if all of the following are true:
-     * - There is no more data to be added to the text buffer
-     * - There is no more data in the text buffer
-     * - There are no chunks that are waiting to be consumed
-     */
-    get streamDone(): boolean;
+declare function complexValue(value: unknown): unknown;
+declare function simpleValue(val: unknown): unknown;
+declare class JsonStream implements AbstractStream {
+  _buffer: string;
+  _bufferOpen: boolean;
+  _firstRun: boolean;
+  /**
+   * Add data to the buffer. This may cause chunks to be generated, if available.
+   * @param data
+   */
+  appendBuffer(data: string): void;
+  /**
+   * Indicate there is no more data that will be added to the text buffer.
+   * This should be called when all the data has been read and added to indicate
+   * that we should process everything remaining in the buffer.
+   */
+  closeBuffer(): void;
+  /**
+   * Skip characters in the buffer till we get to the start of an object.
+   * Then attempt to read a full object.
+   * If we do read a full object, turn it into a chunk and send it to the chunk handler.
+   * Repeat this for as much as we can.
+   */
+  _parseBuffer(): void;
+  /**
+   * If the string is present, move the start of the buffer to the first occurrence
+   * of that string. This is useful for skipping over elements or parts that we're not
+   * really interested in parsing. (ie - the opening characters, comma separators, etc.)
+   * @param start The string to start the buffer with
+   */
+  _skipTo(start: string): void;
+  /**
+   * Given what is in the buffer, parse a single object out of it.
+   * If a complete object isn't available, return null.
+   * Assumes that we are at the start of an object to parse.
+   */
+  _getFullObject(): object | null;
+  _simplifyObject(obj: unknown): object;
+  // Set up a potential Promise that the handler can resolve.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _chunkResolution: (chunk: any) => void;
+  // If there is no Promise (it is null), the handler must add it to the queue
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _chunkPending: Promise<any> | null;
+  // A queue that will collect chunks while there is no Promise
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _chunkQueue: any[];
+  /**
+   * Register that we have another chunk available for consumption.
+   * If we are waiting for a chunk, resolve the promise waiting for it immediately.
+   * If not, then add it to the queue.
+   * @param chunk
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _handleChunk(chunk: any): void;
+  /**
+   * Get the next chunk that is coming from the stream.
+   * This chunk may be null, usually indicating the last chunk in the stream.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  nextChunk(): Promise<any>;
+  /**
+   * Is the stream done?
+   * A stream is only done if all of the following are true:
+   * - There is no more data to be added to the text buffer
+   * - There is no more data in the text buffer
+   * - There are no chunks that are waiting to be consumed
+   */
+  get streamDone(): boolean;
 }
-export declare class ComplexJsonStream extends JsonStream {
-    _simplifyObject(obj: unknown): object;
+declare class ComplexJsonStream extends JsonStream {
+  _simplifyObject(obj: unknown): object;
 }
-export declare class ReadableAbstractStream implements AbstractStream {
-    private baseStream;
-    decoder: TextDecoder;
-    constructor(baseStream: AbstractStream, body: ReadableStream | null);
-    appendBuffer(data: string): void;
-    closeBuffer(): void;
-    nextChunk(): Promise<any>;
-    get streamDone(): boolean;
-    run(body: any): Promise<void>;
+declare class ReadableAbstractStream implements AbstractStream {
+  private baseStream;
+  decoder: TextDecoder;
+  constructor(baseStream: AbstractStream, body: ReadableStream | null);
+  appendBuffer(data: string): void;
+  closeBuffer(): void;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  nextChunk(): Promise<any>;
+  get streamDone(): boolean;
+  // Should be a ReadableStream, but the Gaxios Readable stream isn't.
+  // But both should support async iterators, so make sure of that.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  run(body: any): Promise<void>;
 }
-export declare class ReadableJsonStream extends ReadableAbstractStream {
-    constructor(body: ReadableStream | null);
+declare class ReadableJsonStream extends ReadableAbstractStream {
+  constructor(body: ReadableStream | null);
 }
-export declare class SseStream implements AbstractStream {
-    _buffer: string;
-    _bufferOpen: boolean;
-    appendBuffer(data: string): void;
-    closeBuffer(): void;
-    /**
-     * Attempt to load an entire event.
-     * For each entire event we load,
-     * send them to be handled.
-     */
-    _parseBuffer(): void;
-    /**
-     * Given an event string, get all the fields
-     * in the event. It is assumed there is one field
-     * per line, but that field names can be duplicated,
-     * indicating to append the new value to the previous value
-     * @param event
-     */
-    _parseEvent(event: string | null): Record<string, string> | null;
-    _chunkResolution: (chunk: any) => void;
-    _chunkPending: Promise<any> | null;
-    _chunkQueue: any[];
-    _handleEvent(event: string | null): void;
-    nextChunk(): Promise<any>;
-    get streamDone(): boolean;
+declare class SseStream implements AbstractStream {
+  _buffer: string;
+  _bufferOpen: boolean;
+  appendBuffer(data: string): void;
+  closeBuffer(): void;
+  /**
+   * Attempt to load an entire event.
+   * For each entire event we load,
+   * send them to be handled.
+   */
+  _parseBuffer(): void;
+  /**
+   * Given an event string, get all the fields
+   * in the event. It is assumed there is one field
+   * per line, but that field names can be duplicated,
+   * indicating to append the new value to the previous value
+   * @param event
+   */
+  _parseEvent(event: string | null): Record<string, string> | null;
+  // Set up a potential Promise that the handler can resolve.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _chunkResolution: (chunk: any) => void;
+  // If there is no Promise (it is null), the handler must add it to the queue
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _chunkPending: Promise<any> | null;
+  // A queue that will collect chunks while there is no Promise
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  _chunkQueue: any[];
+  _handleEvent(event: string | null): void;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  nextChunk(): Promise<any>;
+  get streamDone(): boolean;
 }
-export declare class ReadableSseStream extends ReadableAbstractStream {
-    constructor(body: ReadableStream | null);
+declare class ReadableSseStream extends ReadableAbstractStream {
+  constructor(body: ReadableStream | null);
 }
-export declare class SseJsonStream extends SseStream {
-    _jsonAttribute: string;
-    constructor(jsonAttribute?: string);
-    nextChunk(): Promise<any>;
+declare class SseJsonStream extends SseStream {
+  _jsonAttribute: string;
+  constructor(jsonAttribute?: string);
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  nextChunk(): Promise<any>;
 }
-export declare class ReadableSseJsonStream extends ReadableAbstractStream {
-    constructor(body: ReadableStream | null);
+declare class ReadableSseJsonStream extends ReadableAbstractStream {
+  constructor(body: ReadableStream | null);
 }
+//#endregion
+export { AbstractStream, ComplexJsonStream, JsonStream, ReadableAbstractStream, ReadableJsonStream, ReadableSseJsonStream, ReadableSseStream, SseJsonStream, SseStream, complexValue, simpleValue };
+//# sourceMappingURL=stream.d.ts.map

package/dist/utils/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","names":["AbstractStream","Promise","complexValue","simpleValue","JsonStream","ComplexJsonStream","ReadableAbstractStream","TextDecoder","ReadableStream","ReadableJsonStream","SseStream","Record","ReadableSseStream","SseJsonStream","ReadableSseJsonStream"],"sources":["../../src/utils/stream.d.ts"],"sourcesContent":["export interface AbstractStream {\n    /**\n     * Add more text to the buffer\n     * @param data\n     */\n    appendBuffer(data: string): void;\n    /**\n     * Indicate that there is no more text to be added to the buffer\n     * (ie - our source material is done)\n     */\n    closeBuffer(): void;\n    /**\n     * Get the next chunk that is coming from the stream.\n     * This chunk may be null, usually indicating the last chunk in the stream.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nextChunk(): Promise<any>;\n    /**\n     * Is the stream done?\n     * A stream is only done if all of the following are true:\n     * - There is no more data to be added to the text buffer\n     * - There is no more data in the text buffer\n     * - There are no chunks that are waiting to be consumed\n     */\n    get streamDone(): boolean;\n}\nexport declare function complexValue(value: unknown): unknown;\nexport declare function simpleValue(val: unknown): unknown;\nexport declare class JsonStream implements AbstractStream {\n    _buffer: string;\n    _bufferOpen: boolean;\n    _firstRun: boolean;\n    /**\n     * Add data to the buffer. This may cause chunks to be generated, if available.\n     * @param data\n     */\n    appendBuffer(data: string): void;\n    /**\n     * Indicate there is no more data that will be added to the text buffer.\n     * This should be called when all the data has been read and added to indicate\n     * that we should process everything remaining in the buffer.\n     */\n    closeBuffer(): void;\n    /**\n     * Skip characters in the buffer till we get to the start of an object.\n     * Then attempt to read a full object.\n     * If we do read a full object, turn it into a chunk and send it to the chunk handler.\n     * Repeat this for as much as we can.\n     */\n    _parseBuffer(): void;\n    /**\n     * If the string is present, move the start of the buffer to the first occurrence\n     * of that string. This is useful for skipping over elements or parts that we're not\n     * really interested in parsing. (ie - the opening characters, comma separators, etc.)\n     * @param start The string to start the buffer with\n     */\n    _skipTo(start: string): void;\n    /**\n     * Given what is in the buffer, parse a single object out of it.\n     * If a complete object isn't available, return null.\n     * Assumes that we are at the start of an object to parse.\n     */\n    _getFullObject(): object | null;\n    _simplifyObject(obj: unknown): object;\n    // Set up a potential Promise that the handler can resolve.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _chunkResolution: (chunk: any) => void;\n    // If there is no Promise (it is null), the handler must add it to the queue\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _chunkPending: Promise<any> | null;\n    // A queue that will collect chunks while there is no Promise\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _chunkQueue: any[];\n    /**\n     * Register that we have another chunk available for consumption.\n     * If we are waiting for a chunk, resolve the promise waiting for it immediately.\n     * If not, then add it to the queue.\n     * @param chunk\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _handleChunk(chunk: any): void;\n    /**\n     * Get the next chunk that is coming from the stream.\n     * This chunk may be null, usually indicating the last chunk in the stream.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nextChunk(): Promise<any>;\n    /**\n     * Is the stream done?\n     * A stream is only done if all of the following are true:\n     * - There is no more data to be added to the text buffer\n     * - There is no more data in the text buffer\n     * - There are no chunks that are waiting to be consumed\n     */\n    get streamDone(): boolean;\n}\nexport declare class ComplexJsonStream extends JsonStream {\n    _simplifyObject(obj: unknown): object;\n}\nexport declare class ReadableAbstractStream implements AbstractStream {\n    private baseStream;\n    decoder: TextDecoder;\n    constructor(baseStream: AbstractStream, body: ReadableStream | null);\n    appendBuffer(data: string): void;\n    closeBuffer(): void;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nextChunk(): Promise<any>;\n    get streamDone(): boolean;\n    // Should be a ReadableStream, but the Gaxios Readable stream isn't.\n    // But both should support async iterators, so make sure of that.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    run(body: any): Promise<void>;\n}\nexport declare class ReadableJsonStream extends ReadableAbstractStream {\n    constructor(body: ReadableStream | null);\n}\nexport declare class SseStream implements AbstractStream {\n    _buffer: string;\n    _bufferOpen: boolean;\n    appendBuffer(data: string): void;\n    closeBuffer(): void;\n    /**\n     * Attempt to load an entire event.\n     * For each entire event we load,\n     * send them to be handled.\n     */\n    _parseBuffer(): void;\n    /**\n     * Given an event string, get all the fields\n     * in the event. It is assumed there is one field\n     * per line, but that field names can be duplicated,\n     * indicating to append the new value to the previous value\n     * @param event\n     */\n    _parseEvent(event: string | null): Record<string, string> | null;\n    // Set up a potential Promise that the handler can resolve.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _chunkResolution: (chunk: any) => void;\n    // If there is no Promise (it is null), the handler must add it to the queue\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _chunkPending: Promise<any> | null;\n    // A queue that will collect chunks while there is no Promise\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _chunkQueue: any[];\n    _handleEvent(event: string | null): void;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nextChunk(): Promise<any>;\n    get streamDone(): boolean;\n}\nexport declare class ReadableSseStream extends ReadableAbstractStream {\n    constructor(body: ReadableStream | null);\n}\nexport declare class SseJsonStream extends SseStream {\n    _jsonAttribute: string;\n    constructor(jsonAttribute?: string);\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nextChunk(): Promise<any>;\n}\nexport declare class ReadableSseJsonStream extends ReadableAbstractStream {\n    constructor(body: ReadableStream | null);\n}\n"],"mappings":";UAAiBA,cAAAA;EAAAA;AA0BjB;AACA;AACA;EAA+B,YAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAA;;;AAA0B;EAoEpCK,WAAAA,EAAAA,EAAAA,IAAAA;EAGAC;;;;EAGqB;EAAsB,SAI/CL,EAAAA,EA1FAA,OA0FAA,CAAAA,GAAAA,CAAAA;EAAO;;AAP6C;AAcrE;;;;EAAsE,IAAA,UAAA,EAAA,EAAA,OAAA;AAGtE;AAA8B,iBA1FNC,YAAAA,CA0FM,KAAA,EAAA,OAAA,CAAA,EAAA,OAAA;AAkBSS,iBA3GfR,WAAAA,CA2GeQ,GAAAA,EAAAA,OAAAA,CAAAA,EAAAA,OAAAA;AAMpBV,cAhHEG,UAAAA,YAAsBJ,cAgHxBC,CAAAA;EAAO,OAMTA,EAAAA,MAAAA;EAAO,WA9BkBD,EAAAA,OAAAA;EAAc,SAAA,EAAA,OAAA;EAiCnCY;;;;EAAgD,YAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAGhDC;;;;AAA+B;EAM/BC,WAAAA,CAAAA,CAAAA,EAAAA,IAAAA;EAAqB;;;AAA+B;;;;;;;;;;;;;;;;;;;;;;;iBAzFtDb;;;;;;;;;;;;;;;;;eAiBFA;;;;;;;;;;cAUII,iBAAAA,SAA0BD,UAAU;;;cAGpCE,sBAAAA,YAAkCN;;WAE1CO;0BACeP,sBAAsBQ;;;;eAIjCP;;;;;kBAKGA;;cAECQ,kBAAAA,SAA2BH,sBAAAA;oBAC1BE;;cAEDE,SAAAA,YAAqBV;;;;;;;;;;;;;;;;;;qCAkBHW;;;;;;iBAMpBV;;;;;;eAMFA;;;cAGIW,iBAAAA,SAA0BN,sBAAAA;oBACzBE;;cAEDK,aAAAA,SAAsBH,SAAAA;;;;eAI1BT;;cAEIa,qBAAAA,SAA8BR,sBAAAA;oBAC7BE"}