request-iframe 0.1.1 → 0.2.1

package/library/endpoint/stream/errors.d.ts

@@ -0,0 +1,20 @@
+import type { PostMessageData } from '../../types';
+/**
+ * Endpoint Stream integration layer (`src/endpoint/stream`)
+ *
+ * This directory integrates postMessage `stream_*` messages with the stream object system in `src/stream`:
+ * - Endpoint-side composition / protocol glue (e.g. stream_start timeout error payload)
+ * - Does NOT implement the stream protocol itself (protocol lives in `src/stream`)
+ *
+ * Build the ERROR payload for stream_start timeout.
+ *
+ * Used by server-side "request-body stream handshake" when the client fails to send stream_start in time.
+ */
+export declare function buildStreamStartTimeoutErrorPayload(params: {
+    path: string;
+    timeoutMs: number;
+    requireAck?: boolean;
+    ack?: any;
+    targetId?: string;
+}): Partial<Omit<PostMessageData, '__requestIframe__' | 'type' | 'requestId' | 'timestamp' | 'role' | 'creatorId'>>;
+//# sourceMappingURL=errors.d.ts.map

package/library/endpoint/stream/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/endpoint/stream/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD;;;;;;;;;;GAUG;AACH,wBAAgB,mCAAmC,CAAC,MAAM,EAAE;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,mBAAmB,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,CAalH"}

package/library/endpoint/stream/errors.js

@@ -0,0 +1,32 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildStreamStartTimeoutErrorPayload = buildStreamStartTimeoutErrorPayload;
+var _constants = require("../../constants");
+/**
+ * Endpoint Stream integration layer (`src/endpoint/stream`)
+ *
+ * This directory integrates postMessage `stream_*` messages with the stream object system in `src/stream`:
+ * - Endpoint-side composition / protocol glue (e.g. stream_start timeout error payload)
+ * - Does NOT implement the stream protocol itself (protocol lives in `src/stream`)
+ *
+ * Build the ERROR payload for stream_start timeout.
+ *
+ * Used by server-side "request-body stream handshake" when the client fails to send stream_start in time.
+ */
+function buildStreamStartTimeoutErrorPayload(params) {
+  return {
+    path: params.path,
+    error: {
+      message: (0, _constants.formatMessage)(_constants.Messages.STREAM_START_TIMEOUT, params.timeoutMs),
+      code: _constants.ErrorCode.STREAM_START_TIMEOUT
+    },
+    status: _constants.HttpStatus.REQUEST_TIMEOUT,
+    statusText: _constants.HttpStatusText[_constants.HttpStatus.REQUEST_TIMEOUT],
+    requireAck: params.requireAck,
+    ack: params.ack,
+    targetId: params.targetId
+  };
+}

package/library/endpoint/stream/factory.d.ts

@@ -0,0 +1,44 @@
+import type { PostMessageData } from '../../types';
+import type { StreamMessageHandler } from '../../stream';
+import { IframeReadableStream, IframeFileReadableStream } from '../../stream';
+/**
+ * Endpoint Stream integration layer (`src/endpoint/stream`)
+ *
+ * This directory integrates postMessage `stream_*` messages with the stream object system in `src/stream`:
+ * - Parses stream_start and creates the corresponding ReadableStream (data/file)
+ * - Does NOT implement the stream protocol itself (protocol lives in `src/stream`)
+ */
+/**
+ * Parsed stream_start body info.
+ */
+export interface StreamStartInfo {
+    streamId: string;
+    type: string;
+    mode?: any;
+    chunked: boolean;
+    metadata?: Record<string, any>;
+    autoResolve: boolean;
+}
+/**
+ * Parse stream_start body with defaults.
+ */
+export declare function parseStreamStart(body: any): StreamStartInfo | null;
+/**
+ * Create a readable stream instance from a stream_start message/body.
+ *
+ * This is shared by:
+ * - client side: receiving response stream from server
+ * - server side: receiving request-body stream from client
+ */
+export declare function createReadableStreamFromStart(params: {
+    requestId: string;
+    data: PostMessageData;
+    handler: StreamMessageHandler;
+    secretKey?: string;
+    idleTimeout?: number;
+    heartbeat?: () => Promise<boolean>;
+}): {
+    stream: IframeReadableStream<any> | IframeFileReadableStream;
+    info: StreamStartInfo;
+} | null;
+//# sourceMappingURL=factory.d.ts.map

package/library/endpoint/stream/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/endpoint/stream/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAqB,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAG9E;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,eAAe,GAAG,IAAI,CAWlE;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACpC,GAAG;IAAE,MAAM,EAAE,oBAAoB,CAAC,GAAG,CAAC,GAAG,wBAAwB,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAAG,IAAI,CA+BjG"}

package/library/endpoint/stream/factory.js

@@ -0,0 +1,82 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createReadableStreamFromStart = createReadableStreamFromStart;
+exports.parseStreamStart = parseStreamStart;
+var _stream = require("../../stream");
+var _constants = require("../../constants");
+/**
+ * Endpoint Stream integration layer (`src/endpoint/stream`)
+ *
+ * This directory integrates postMessage `stream_*` messages with the stream object system in `src/stream`:
+ * - Parses stream_start and creates the corresponding ReadableStream (data/file)
+ * - Does NOT implement the stream protocol itself (protocol lives in `src/stream`)
+ */
+
+/**
+ * Parsed stream_start body info.
+ */
+
+/**
+ * Parse stream_start body with defaults.
+ */
+function parseStreamStart(body) {
+  var _chunked, _autoResolve;
+  var b = body;
+  if (!(b !== null && b !== void 0 && b.streamId)) return null;
+  return {
+    streamId: b.streamId,
+    type: b.type || _constants.StreamType.DATA,
+    mode: b.mode,
+    chunked: (_chunked = b.chunked) !== null && _chunked !== void 0 ? _chunked : true,
+    metadata: b.metadata,
+    autoResolve: (_autoResolve = b.autoResolve) !== null && _autoResolve !== void 0 ? _autoResolve : false
+  };
+}
+
+/**
+ * Create a readable stream instance from a stream_start message/body.
+ *
+ * This is shared by:
+ * - client side: receiving response stream from server
+ * - server side: receiving request-body stream from client
+ */
+function createReadableStreamFromStart(params) {
+  var _params$secretKey;
+  var info = parseStreamStart(params.data.body);
+  if (!info) return null;
+  var secretKey = (_params$secretKey = params.secretKey) !== null && _params$secretKey !== void 0 ? _params$secretKey : params.data.secretKey;
+  if (info.type === _constants.StreamType.FILE) {
+    var _info$metadata, _info$metadata2, _info$metadata3;
+    var fileStream = new _stream.IframeFileReadableStream(info.streamId, params.requestId, params.handler, {
+      chunked: info.chunked,
+      metadata: info.metadata,
+      secretKey,
+      mode: info.mode,
+      idleTimeout: params.idleTimeout,
+      heartbeat: params.heartbeat,
+      filename: (_info$metadata = info.metadata) === null || _info$metadata === void 0 ? void 0 : _info$metadata.filename,
+      mimeType: (_info$metadata2 = info.metadata) === null || _info$metadata2 === void 0 ? void 0 : _info$metadata2.mimeType,
+      size: (_info$metadata3 = info.metadata) === null || _info$metadata3 === void 0 ? void 0 : _info$metadata3.size
+    });
+    return {
+      stream: fileStream,
+      info
+    };
+  }
+  var readableStream = new _stream.IframeReadableStream(info.streamId, params.requestId, params.handler, {
+    type: info.type,
+    mode: info.mode,
+    chunked: info.chunked,
+    metadata: info.metadata,
+    secretKey,
+    idleTimeout: params.idleTimeout,
+    heartbeat: params.heartbeat
+  });
+  return {
+    stream: readableStream,
+    info
+  };
+}

package/library/endpoint/stream/file-auto-resolve.d.ts

@@ -0,0 +1,26 @@
+import type { StreamStartInfo } from './factory';
+import type { IframeFileReadableStream } from '../../stream';
+/**
+ * Endpoint Stream integration layer (`src/endpoint/stream`)
+ *
+ * This directory integrates postMessage `stream_*` messages with the stream object system in `src/stream`:
+ * - Endpoint-side file stream utilities (e.g. choose filename from header/metadata and auto-resolve)
+ * - Does NOT implement the stream protocol itself (protocol lives in `src/stream`)
+ *
+ * Parse filename from Content-Disposition header.
+ */
+export declare function parseFilenameFromContentDisposition(value?: string | string[]): string | undefined;
+/**
+ * Auto resolve a file readable stream to File/Blob.
+ *
+ * Filename priority:
+ * - Content-Disposition filename (if provided)
+ * - stream_start metadata filename (if provided)
+ * - stream.filename (if provided)
+ */
+export declare function autoResolveIframeFileReadableStream(params: {
+    fileStream: IframeFileReadableStream;
+    info?: StreamStartInfo | null;
+    headers?: Record<string, string | string[]>;
+}): Promise<File | Blob>;
+//# sourceMappingURL=file-auto-resolve.d.ts.map

package/library/endpoint/stream/file-auto-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-auto-resolve.d.ts","sourceRoot":"","sources":["../../../src/endpoint/stream/file-auto-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;;;;GAQG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAMjG;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,MAAM,EAAE;IAC1D,UAAU,EAAE,wBAAwB,CAAC;IACrC,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC7C,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAIvB"}

package/library/endpoint/stream/file-auto-resolve.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.autoResolveIframeFileReadableStream = autoResolveIframeFileReadableStream;
+exports.parseFilenameFromContentDisposition = parseFilenameFromContentDisposition;
+require("core-js/modules/es.regexp.exec.js");
+require("core-js/modules/es.string.match.js");
+var _constants = require("../../constants");
+/**
+ * Endpoint Stream integration layer (`src/endpoint/stream`)
+ *
+ * This directory integrates postMessage `stream_*` messages with the stream object system in `src/stream`:
+ * - Endpoint-side file stream utilities (e.g. choose filename from header/metadata and auto-resolve)
+ * - Does NOT implement the stream protocol itself (protocol lives in `src/stream`)
+ *
+ * Parse filename from Content-Disposition header.
+ */
+function parseFilenameFromContentDisposition(value) {
+  if (!value) return undefined;
+  var disposition = typeof value === 'string' ? value : value[0];
+  if (!disposition) return undefined;
+  var match = disposition.match(/filename="?([^"]+)"?/i);
+  return match ? match[1] : undefined;
+}
+
+/**
+ * Auto resolve a file readable stream to File/Blob.
+ *
+ * Filename priority:
+ * - Content-Disposition filename (if provided)
+ * - stream_start metadata filename (if provided)
+ * - stream.filename (if provided)
+ */
+function autoResolveIframeFileReadableStream(params) {
+  var _params$headers, _params$info;
+  var headerFilename = parseFilenameFromContentDisposition((_params$headers = params.headers) === null || _params$headers === void 0 ? void 0 : _params$headers[_constants.HttpHeader.CONTENT_DISPOSITION]);
+  var fileName = headerFilename || ((_params$info = params.info) === null || _params$info === void 0 || (_params$info = _params$info.metadata) === null || _params$info === void 0 ? void 0 : _params$info.filename) || params.fileStream.filename;
+  return fileName ? params.fileStream.readAsFile(fileName) : params.fileStream.readAsBlob();
+}

package/library/endpoint/stream/file-writable.d.ts

@@ -0,0 +1,33 @@
+import type { IframeFileWritableStream } from '../../stream';
+/**
+ * Endpoint Stream integration layer (`src/endpoint/stream`)
+ *
+ * This directory integrates postMessage `stream_*` messages with the stream object system in `src/stream`:
+ * - Endpoint-side File/Blob -> IframeFileWritableStream adaptation (for sendFile / res.sendFile)
+ * - Does NOT implement the stream protocol itself (protocol lives in `src/stream`)
+ *
+ * Create an IframeFileWritableStream from content.
+ *
+ * Shared by:
+ * - client: sendFile(...) -> sendStream(...)
+ * - server response: res.sendFile(...) -> sendStream(...)
+ */
+export declare function createIframeFileWritableStreamFromContent(params: {
+    content: string | Blob | File;
+    fileName?: string;
+    mimeType?: string;
+    /** default: false (file is sent in one chunk) */
+    chunked?: boolean;
+    /** default: true (receiver may auto-resolve) */
+    autoResolve?: boolean;
+    /** stream filename fallback when fileName cannot be inferred */
+    defaultFileName?: string;
+    /** mimeType fallback when mimeType cannot be inferred */
+    defaultMimeType?: string;
+}): Promise<{
+    stream: IframeFileWritableStream;
+    /** inferred filename (may be undefined if content is not File and fileName not provided) */
+    fileName?: string;
+    mimeType: string;
+}>;
+//# sourceMappingURL=file-writable.d.ts.map

package/library/endpoint/stream/file-writable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-writable.d.ts","sourceRoot":"","sources":["../../../src/endpoint/stream/file-writable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAG7D;;;;;;;;;;;;GAYG;AACH,wBAAsB,yCAAyC,CAAC,MAAM,EAAE;IACtE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,wBAAwB,CAAC;IACjC,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CA0CD"}

package/library/endpoint/stream/file-writable.js

@@ -0,0 +1,115 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createIframeFileWritableStreamFromContent = createIframeFileWritableStreamFromContent;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.promise.js");
+require("core-js/modules/es.weak-map.js");
+require("core-js/modules/web.dom-collections.iterator.js");
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _blob = require("../../utils/blob");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t2 in e) "default" !== _t2 && {}.hasOwnProperty.call(e, _t2) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t2)) && (i.get || i.set) ? o(f, _t2, i) : f[_t2] = e[_t2]); return f; })(e, t); }
+/**
+ * Endpoint Stream integration layer (`src/endpoint/stream`)
+ *
+ * This directory integrates postMessage `stream_*` messages with the stream object system in `src/stream`:
+ * - Endpoint-side File/Blob -> IframeFileWritableStream adaptation (for sendFile / res.sendFile)
+ * - Does NOT implement the stream protocol itself (protocol lives in `src/stream`)
+ *
+ * Create an IframeFileWritableStream from content.
+ *
+ * Shared by:
+ * - client: sendFile(...) -> sendStream(...)
+ * - server response: res.sendFile(...) -> sendStream(...)
+ */
+function createIframeFileWritableStreamFromContent(_x) {
+  return _createIframeFileWritableStreamFromContent.apply(this, arguments);
+}
+function _createIframeFileWritableStreamFromContent() {
+  _createIframeFileWritableStreamFromContent = (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee2(params) {
+    var _params$chunked, _params$autoResolve;
+    var _yield$import, IframeFileWritableStream, mimeType, fileName, t, fileContent, streamFileName, stream, _t;
+    return _regenerator.default.wrap(function (_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          _context2.next = 1;
+          return Promise.resolve().then(() => _interopRequireWildcard(require('../../stream')));
+        case 1:
+          _yield$import = _context2.sent;
+          IframeFileWritableStream = _yield$import.IframeFileWritableStream;
+          mimeType = params.mimeType || params.defaultMimeType || 'application/octet-stream';
+          fileName = params.fileName;
+          try {
+            if (typeof File !== 'undefined' && params.content instanceof File) {
+              mimeType = params.content.type || mimeType;
+              fileName = fileName || params.content.name;
+            }
+          } catch (_unused) {
+            /** ignore */
+          }
+          try {
+            if (!fileName && typeof Blob !== 'undefined' && params.content instanceof Blob) {
+              t = params.content.type;
+              if (t) mimeType = t;
+            }
+          } catch (_unused2) {
+            /** ignore */
+          }
+          if (!(typeof params.content === 'string')) {
+            _context2.next = 2;
+            break;
+          }
+          _t = btoa(unescape(encodeURIComponent(params.content)));
+          _context2.next = 4;
+          break;
+        case 2:
+          _context2.next = 3;
+          return (0, _blob.blobToBase64)(params.content);
+        case 3:
+          _t = _context2.sent;
+        case 4:
+          fileContent = _t;
+          streamFileName = fileName || params.defaultFileName || 'file';
+          stream = new IframeFileWritableStream({
+            filename: streamFileName,
+            mimeType,
+            chunked: (_params$chunked = params.chunked) !== null && _params$chunked !== void 0 ? _params$chunked : false,
+            autoResolve: (_params$autoResolve = params.autoResolve) !== null && _params$autoResolve !== void 0 ? _params$autoResolve : true,
+            next: function () {
+              var _next = (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee() {
+                return _regenerator.default.wrap(function (_context) {
+                  while (1) switch (_context.prev = _context.next) {
+                    case 0:
+                      return _context.abrupt("return", {
+                        data: fileContent,
+                        done: true
+                      });
+                    case 1:
+                    case "end":
+                      return _context.stop();
+                  }
+                }, _callee);
+              }));
+              function next() {
+                return _next.apply(this, arguments);
+              }
+              return next;
+            }()
+          });
+          return _context2.abrupt("return", {
+            stream,
+            fileName,
+            mimeType
+          });
+        case 5:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  }));
+  return _createIframeFileWritableStreamFromContent.apply(this, arguments);
+}

package/library/endpoint/stream/handler.d.ts

@@ -0,0 +1,20 @@
+import type { StreamMessageHandler } from '../../stream';
+import type { RequestIframeStreamDispatcher } from './dispatcher';
+/**
+ * Endpoint Stream integration layer (`src/endpoint/stream`)
+ *
+ * This directory integrates postMessage `stream_*` messages with the stream object system in `src/stream`:
+ * - Adapts (dispatcher + postMessage) into the `StreamMessageHandler` interface used by `src/stream`
+ * - Does NOT implement the stream protocol itself (protocol lives in `src/stream`)
+ *
+ * Create a StreamMessageHandler bound to a stream dispatcher and a postMessage implementation.
+ *
+ * This is shared by:
+ * - server side: receiving request-body streams (per request targetWindow/targetOrigin)
+ * - client side: can also use it in the future to avoid implementing the interface on the client class
+ */
+export declare function createStreamMessageHandler(params: {
+    dispatcher: RequestIframeStreamDispatcher;
+    postMessage: (message: any) => void;
+}): StreamMessageHandler;
+//# sourceMappingURL=handler.d.ts.map

package/library/endpoint/stream/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/endpoint/stream/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,UAAU,EAAE,6BAA6B,CAAC;IAC1C,WAAW,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;CACrC,GAAG,oBAAoB,CAYvB"}

package/library/endpoint/stream/handler.js

@@ -0,0 +1,32 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createStreamMessageHandler = createStreamMessageHandler;
+/**
+ * Endpoint Stream integration layer (`src/endpoint/stream`)
+ *
+ * This directory integrates postMessage `stream_*` messages with the stream object system in `src/stream`:
+ * - Adapts (dispatcher + postMessage) into the `StreamMessageHandler` interface used by `src/stream`
+ * - Does NOT implement the stream protocol itself (protocol lives in `src/stream`)
+ *
+ * Create a StreamMessageHandler bound to a stream dispatcher and a postMessage implementation.
+ *
+ * This is shared by:
+ * - server side: receiving request-body streams (per request targetWindow/targetOrigin)
+ * - client side: can also use it in the future to avoid implementing the interface on the client class
+ */
+function createStreamMessageHandler(params) {
+  return {
+    registerStreamHandler: (streamId, handler) => {
+      params.dispatcher.register(streamId, handler);
+    },
+    unregisterStreamHandler: streamId => {
+      params.dispatcher.unregister(streamId);
+    },
+    postMessage: message => {
+      params.postMessage(message);
+    }
+  };
+}

package/library/{core → impl}/client.d.ts

@@ -1,6 +1,6 @@
 import type { RequestOptions, Response, RequestIframeClient, RequestDefaults, HeadersConfig, OriginMatcher, OriginValidator } from '../types';
 import { RequestInterceptorManager, ResponseInterceptorManager } from '../interceptors';
-import { RequestIframeClientServer } from './client-server';
+import { RequestIframeEndpointHub } from '../endpoint';
 import { IframeWritableStream, StreamMessageHandler, StreamMessageData } from '../stream';
 /**
  * Client configuration options
@@ -10,6 +10,8 @@ export interface ClientOptions extends RequestDefaults {
     headers?: HeadersConfig;
     allowedOrigins?: OriginMatcher;
     validateOrigin?: OriginValidator;
+    /** Whether to automatically open when creating the client. Default is true. */
+    autoOpen?: boolean;
 }
 /**
  * RequestIframeClient implementation (only responsible for initiating requests, reuses server's listener)
@@ -23,7 +25,10 @@ export declare class RequestIframeClientImpl implements RequestIframeClient, Str
     };
     readonly targetWindow: Window;
     private readonly targetOrigin;
-    private readonly server;
+    private readonly endpoint;
+    private readonly hub;
+    private readonly inbox;
+    private readonly outbox;
     private readonly secretKey?;
     private readonly originValidator?;
     /** Default timeout configuration */
@@ -40,18 +45,14 @@ export declare class RequestIframeClientImpl implements RequestIframeClient, Str
      * - Automatically parses Set-Cookie and saves when receiving response
      */
     private _cookieStore;
-    /**
-     * Stream message handler map
-     * key: streamId
-     * value: stream message handler function
-     */
-    private readonly streamHandlers;
+    private readonly streamDispatcher;
     /**
      * Target server ID (remembered from responses)
      * When a response is received, we remember the server's creatorId as the targetId for future requests
      */
     private _targetServerId?;
-    constructor(targetWindow: Window, targetOrigin: string, server: RequestIframeClientServer, options?: ClientOptions, instanceId?: string);
+    private rememberTargetServerId;
+    constructor(targetWindow: Window, targetOrigin: string, options?: ClientOptions, instanceId?: string);
     /**
      * Register stream message handler (StreamMessageHandler interface implementation)
      */
@@ -62,9 +63,11 @@ export declare class RequestIframeClientImpl implements RequestIframeClient, Str
     unregisterStreamHandler(streamId: string): void;
     postMessage(message: any): void;
     /**
-     * Dispatch stream message to corresponding handler
+     * Send raw framework message (advanced).
+     *
+     * Note: streams call `postMessage` via StreamMessageHandler, which delegates here.
      */
-    private dispatchStreamMessage;
+    sendRaw(message: any): void;
     /**
      * Resolve header value (handle function type headers)
      */
@@ -106,9 +109,9 @@ export declare class RequestIframeClientImpl implements RequestIframeClient, Str
      */
     private _sendRequest;
     /**
-     * Get internal server instance (for debugging)
+     * Get internal hub instance (for debugging)
      */
-    getServer(): RequestIframeClientServer;
+    getHub(): RequestIframeEndpointHub;
     /**
      * Whether message handling is enabled
      */

package/library/impl/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/impl/client.ts"],"names":[],"mappings":"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"}