effect-browser 0.2.0-beta.6 → 0.2.0-beta.8

package/dist/CaptureData-Dys0Ko9d.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"CaptureData-Dys0Ko9d.mjs","names":[],"sources":["../src/internal/capture/Options.ts","../src/CaptureData.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\nexport const Dimension = Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 16384 }));\nconst BufferedBytes = Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 64 * 1024 * 1024 }));\n\n/**\n * Upper bounds of one interval. Frames can be held for as long as a consumer delays them, so the\n * frame bound is set by memory (the byte bound), not by a short hand-off; an interval can last\n * as long as a session may.\n */\nexport const CaptureMaxima = Object.freeze({ frames: 1024, durationMillis: 21_600_000 });\n\n/** Defaults shared by runtime admission and the optional public data schema. */\nexport const CaptureDefaults = Object.freeze({\n  maxFrames: 4,\n  maxBufferedBytes: 16 * 1024 * 1024,\n  maxFrameBytes: 4 * 1024 * 1024,\n  maxDurationMillis: 60000,\n  quality: 80,\n});\n\nexport const LimitFields = {\n  maxFrames: Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: CaptureMaxima.frames })),\n  maxBufferedBytes: BufferedBytes,\n  maxFrameBytes: BufferedBytes,\n  maxDurationMillis: Schema.Int.check(\n    Schema.isBetween({ minimum: 1, maximum: CaptureMaxima.durationMillis }),\n  ),\n  quality: Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 100 })),\n};\n\nexport const FrameBudget = Schema.makeFilter(\n  (value: { readonly maxFrameBytes?: number; readonly maxBufferedBytes?: number }) =>\n    (value.maxFrameBytes ?? CaptureDefaults.maxFrameBytes) <=\n    (value.maxBufferedBytes ?? CaptureDefaults.maxBufferedBytes),\n  { message: \"A frame must fit within the resolved buffer budget\" },\n);\n\n/** Fully resolved admission values; callers supply the optional public CaptureOptions instead. */\nexport const CaptureLimits = Schema.Struct(LimitFields).check(FrameBudget);\n","import { Schema } from \"effect\";\n\nimport { PageInfo, Target } from \"./BrowserData.ts\";\nimport { BrowserError } from \"./Errors.ts\";\nimport { Dimension, FrameBudget, LimitFields } from \"./internal/capture/Options.ts\";\n\n/**\n * Binary frame data, not a live capability or a JSON/thread/Tool value. Decoding validates\n * fields; it does not copy bytes, decode JPEG pixels, prove target authority, or repair clocks.\n * Capture itself owns the byte copy, freezes its shared target identity, and verifies JPEG framing.\n */\nexport const CapturedFrame = Schema.Struct({\n  bytes: Schema.Uint8Array.check(Schema.isMinLength(4), Schema.isMaxLength(64 * 1024 * 1024)),\n  mediaType: Schema.Literal(\"image/jpeg\"),\n  target: Target,\n  sequence: Schema.Natural,\n  /**\n   * Which document of its page this frame was received during: 0 at the start, one more for each\n   * main-frame navigation the interval observed. It is attribution by receipt order, not proof\n   * of whose pixels these are: a frame received just after a navigation can still show the\n   * document before it. Always 0 for an interval that lasts one document.\n   */\n  document: Schema.Natural,\n  sourceTimeMillis: Schema.Finite.check(Schema.isGreaterThan(0)),\n  sourceClock: Schema.Literal(\"presentation-unix-millis\"),\n  receivedMonotonicNanos: Schema.BigInt,\n  width: Dimension,\n  height: Dimension,\n  viewportWidth: Dimension,\n  viewportHeight: Dimension,\n}).check(\n  Schema.makeFilter((frame) => frame.width * frame.height <= 33_554_432, {\n    message: \"Frame geometry exceeds the capture pixel bound\",\n  }),\n);\n\nexport type CapturedFrame = typeof CapturedFrame.Type;\n\n/** Source-fit request in pixels. Actual JPEG bounds are checked before any frame is delivered. */\nexport const CaptureSize = Schema.Struct({ width: Dimension, height: Dimension });\n\nexport type CaptureSize = typeof CaptureSize.Type;\n\n/** Optional capture data. Defaults are applied at admission, not during schema decoding. */\nexport const CaptureOptions = Schema.Struct({\n  /** Pin to a page from `session.pages`; omission preserves selected-page behavior. */\n  target: Schema.optionalKey(PageInfo),\n  /**\n   * Frames held until the consumer takes them (4 by default, at most 1024), oldest dropped first\n   * and counted as `overflow`. A consumer that delays its output leaves frames here, so this and\n   * `maxBufferedBytes` are the delay's memory bound.\n   */\n  maxFrames: Schema.optionalKey(LimitFields.maxFrames),\n  maxBufferedBytes: Schema.optionalKey(LimitFields.maxBufferedBytes),\n  maxFrameBytes: Schema.optionalKey(LimitFields.maxFrameBytes),\n  /** 60 seconds by default, at most six hours: as long as a session may last. */\n  maxDurationMillis: Schema.optionalKey(LimitFields.maxDurationMillis),\n  quality: Schema.optionalKey(LimitFields.quality),\n  /** Source fit only. Does not resize the viewport or impose an FPS cap. */\n  size: Schema.optionalKey(CaptureSize),\n  /**\n   * `document`, the default, ends the interval when its page navigates. `page` follows the page\n   * across documents, so a capture started before a navigation covers the loading in between.\n   * It applies to a page's main frame; a capture bound to a child frame still ends with it.\n   */\n  lifetime: Schema.optionalKey(Schema.Literals([\"document\", \"page\"])),\n}).check(FrameBudget);\n\nexport type CaptureOptions = typeof CaptureOptions.Type;\n\n/** An address as the browser reported it. One longer than this is recorded as null, not cut. */\nconst DocumentUrl = Schema.NullOr(Schema.String.check(Schema.isMaxLength(8192)));\n\nexport class CaptureSummary extends Schema.Class<CaptureSummary>(\"BrowserCaptureSummary\")({\n  target: Target,\n  reason: Schema.String.check(Schema.isMaxLength(64)),\n  received: Schema.Natural,\n  delivered: Schema.Natural,\n  /** All frames this package omitted; the sum of the four disjoint components below. */\n  discarded: Schema.Natural,\n  /** Evicted by the frame-count or buffered-byte bound. */\n  overflow: Schema.Natural,\n  duplicates: Schema.Natural,\n  /** Arrived after a newer frame was accepted; never reordered in. */\n  late: Schema.Natural,\n  /** Other refused frames, including malformed data, bounds and undelivered scope cleanup. */\n  rejected: Schema.Natural,\n  peakBufferedFrames: Schema.Natural,\n  peakBufferedBytes: Schema.Natural,\n  bufferedFrames: Schema.Natural,\n  bufferedBytes: Schema.Natural,\n  sourceFirstMillis: Schema.NullOr(Schema.Finite),\n  sourceLastMillis: Schema.NullOr(Schema.Finite),\n  /**\n   * The captured frame's address when this interval began watching it: the URL of document 0.\n   * It is read in the same turn the watch is installed, so no navigation can fall between them.\n   */\n  initialUrl: DocumentUrl,\n  /**\n   * Each main-frame URL change a `page` interval observed, in order, with the last frame\n   * received before it and the address it reached. `sameDocument` is true when the existing\n   * document changed its URL; it retains the current document number. The native screencast is\n   * never restarted for one, so a boundary is not a gap this package introduced; what Chromium\n   * omitted while loading stays `upstreamDrops`. A boundary is the commit. When that navigation\n   * started and when its document finished loading are the caller's to stamp, on this same\n   * clock, around the operation that caused it. A title is page state, not part of a transition.\n   */\n  documentBoundaries: Schema.Array(\n    Schema.Struct({\n      document: Schema.Natural,\n      sameDocument: Schema.Boolean,\n      observedMonotonicNanos: Schema.BigInt,\n      afterSequence: Schema.NullOr(Schema.Natural),\n      url: DocumentUrl,\n    }),\n  ).check(Schema.isMaxLength(64)),\n  /**\n   * More navigations were observed than are recorded above, so the earliest were let go: the\n   * record keeps the latest 64. Frames still count them all.\n   */\n  documentBoundariesTruncated: Schema.Boolean,\n  nativeStop: Schema.Literals([\"confirmed\", \"unconfirmed\"]),\n  /** Package accounting cannot measure frames omitted by Chromium, transport, or the provider. */\n  upstreamDrops: Schema.Literal(\"unknown\"),\n  error: Schema.optionalKey(BrowserError),\n}) {}\n\nconst { reason: StopReason, nativeStop: NativeStop, ...SnapshotFields } = CaptureSummary.fields;\n\n/**\n * Host-side metadata at one instant, without reading or waking the page. The boundary prefix\n * and loss counters are the same facts as the final summary, independent of frame consumption.\n * `stopped` means native cleanup settled; buffered frames may still be drained afterwards.\n */\nexport class CaptureSnapshot extends Schema.Class<CaptureSnapshot>(\"BrowserCaptureSnapshot\")({\n  ...SnapshotFields,\n  phase: Schema.Literals([\"capturing\", \"stopping\", \"stopped\"]),\n  observedMonotonicNanos: Schema.BigInt,\n  /** Keeps counting when the bounded boundary prefix is truncated. */\n  currentDocument: Schema.Natural,\n  /** No reason is reported while the capture still accepts frames. */\n  reason: Schema.NullOr(StopReason),\n  /** Null until the native cleanup attempt settles; unconfirmed never means stopped remotely. */\n  nativeStop: Schema.NullOr(NativeStop),\n}) {}\n"],"mappings":"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"}

package/dist/PageControlAssociation-DabEg5AR.mjs

@@ -1,10 +0,0 @@
-//#region src/internal/browser/PageControlAssociation.ts
-const owners = /* @__PURE__ */ new WeakMap();
-const associatePageControl = (session, port) => {
-	owners.set(session, port);
-};
-const pageControl = (session) => owners.get(session);
-//#endregion
-export { pageControl as n, associatePageControl as t };
-
-//# sourceMappingURL=PageControlAssociation-DabEg5AR.mjs.map

package/dist/PageControlAssociation-DabEg5AR.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"PageControlAssociation-DabEg5AR.mjs","names":[],"sources":["../src/internal/browser/PageControlAssociation.ts"],"sourcesContent":["import type { Effect } from \"effect\";\n\nimport type { PageExecutionState, PageInfo, PageSuspension } from \"../../BrowserData.ts\";\nimport type { BrowserError } from \"../../Errors.ts\";\n\nexport interface PageControlPort {\n  readonly state: (page: PageInfo) => Effect.Effect<PageExecutionState, BrowserError>;\n  readonly suspend: (page: PageInfo) => Effect.Effect<PageSuspension, BrowserError>;\n  readonly resume: (receipt: PageSuspension) => Effect.Effect<void, BrowserError>;\n}\n\nconst owners = new WeakMap<object, PageControlPort>();\n\nexport const associatePageControl = (session: object, port: PageControlPort): void => {\n  owners.set(session, port);\n};\n\nexport const pageControl = (session: object): PageControlPort | undefined => owners.get(session);\n"],"mappings":";AAWA,MAAM,yBAAS,IAAI,QAAiC;AAEpD,MAAa,wBAAwB,SAAiB,SAAgC;CACpF,OAAO,IAAI,SAAS,IAAI;AAC1B;AAEA,MAAa,eAAe,YAAiD,OAAO,IAAI,OAAO"}