3.0.16

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@api.global/typedrequest-interfaces",
-  "version": "3.0.0",
+  "version": "3.0.16",
   "private": false,
   "description": "interfaces for making typed requests",
   "main": "dist_ts/index.js",

ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@api.global/typedrequest-interfaces',
-  version: '3.0.0',
+  version: '3.0.16',
   description: 'interfaces for making typed requests'
 }

ts/index.ts

@@ -11,6 +11,14 @@ export interface ITypedRequest {
     jwt: string;
   };
 
+  /**
+   * localData tracks things within typedrequest.
+   * needed for VirtualStreams
+   */
+  localData?: {
+    firstTypedrouter?: any;
+  };
+
   /**
    * server data that is added for dealing with the request server side. Will be omitted when sending the response
    */
@@ -44,6 +52,8 @@ export interface ITypedRequest {
 
   /**
    * a correlation id that
+   * used for matching request and response
+   * !important. Don't remove.
    */
   correlation?: {
     id: string;
@@ -65,3 +75,76 @@ export interface ITag {
 }
 
 export type implementsTag<T, U extends T> = {};
+
+
+// stream stuff
+export interface IVirtualStream<T = ArrayBufferLike> {
+  // Properties
+  side: 'requesting' | 'responding';
+  streamId: string;
+
+  // Methods
+  handleStreamTr(streamTrArg: IStreamRequest): Promise<IStreamRequest>;
+  cleanup(): Promise<void>;
+  sendData(dataArg: T): Promise<void>;
+  fetchData(): Promise<T>;
+  pipeWebStream(webStream: any): void; // Consider defining a more specific type for webStream if possible
+}
+
+export interface IUnifiedStreamDataPackage {
+  /**
+   * the stream id, so Virtual Streams can talk to each other
+   */
+  streamId: string;
+
+  /**
+   * stream data is sent in cycles. This id is used to match the request and response
+   */
+  cycleId: string;
+  cycle: 'request' | 'response';
+
+  /**
+   * the main purpose of the data package
+   * start: indicates the start of a stream
+   * chunk: indicates a binary chunk of data
+   * read: indicates the introduction to send data
+   * end: indicates the end of a stream
+   * feedback: indicates a feedback message
+   */
+  mainPurpose: 'start' | 'chunk' | 'read' | 'end' | 'feedback' | 'keepAlive';
+
+  /**
+   * the data package
+   */
+  chunkData?: any;
+  
+  /**
+   * feedback message
+   */
+  feedback?: {
+    message?: string;
+    data?: any;
+    sha265?: string;
+  };
+
+  /**
+   * keepAlive boolean
+   */
+  keepAlive?: boolean;
+
+  /**
+   * is backpressure detected on the readable side?
+   */
+  backpressure?: boolean;
+
+  /**
+   * does the writable side have more data scheduled to be sent?
+   */
+  next?: boolean;
+}
+
+export interface IStreamRequest extends implementsTR<ITypedRequest, IStreamRequest> {
+  method: '##VirtualStream##';
+  request: IUnifiedStreamDataPackage;
+  response: IUnifiedStreamDataPackage;
+}

tsconfig.json

@@ -3,9 +3,12 @@
     "experimentalDecorators": true,
     "useDefineForClassFields": false,
     "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "nodenext",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
     "esModuleInterop": true,
-    "verbatimModuleSyntax": true,
-  }
+    "verbatimModuleSyntax": true
+  },
+  "exclude": [
+    "dist_*/**/*.d.ts"
+  ]
 }