effect-browser 0.2.0-beta.5 → 0.2.0-beta.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "effect-browser",
-  "version": "0.2.0-beta.5",
+  "version": "0.2.0-beta.7",
   "description": "Shared Effect browser sessions, modeled control and capture with an isolated Chromium launcher.",
   "license": "MIT",
   "repository": {

package/dist/Association-BsSfBYVx.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Association-BsSfBYVx.mjs","names":[],"sources":["../src/internal/browser/NativeCalls.ts","../src/internal/browser/Images.ts","../src/internal/browser/Association.ts"],"sourcesContent":["import { Exit, Schema } from \"effect\";\n\nimport {\n  BrowserError,\n  BrowserOutcome,\n  Reasons,\n  type BrowserOperation,\n  type BrowserReason,\n} from \"../../Errors.ts\";\nimport type { ReadTicket } from \"./Owner.ts\";\n\n/**\n * A native step failed. It names no operation: the owner stamps the one the caller asked for\n * when it admits the work, so a step's own vocabulary can never become public API.\n */\nexport class NativeFailure extends Schema.TaggedError<NativeFailure>()(\"NativeFailure\", {\n  reason: BrowserError.fields.reason,\n  // Some native helpers run both before and after dispatch. Only their owner has that evidence.\n  outcome: Schema.optionalKey(BrowserOutcome),\n}) {}\n\n/**\n * The only way a native failure becomes public. A fenced ticket already speaks publicly and\n * passes through with the operation the owner gave it; a native failure keeps its reason and\n * takes the caller's operation; anything else is the caller's fallback.\n */\nexport const publicError = (\n  error: unknown,\n  operation: BrowserOperation,\n  fallback: Pick<BrowserError, \"reason\" | \"outcome\">,\n): BrowserError => {\n  if (Schema.is(BrowserError)(error)) return error;\n  const known = Schema.is(NativeFailure)(error) ? error : fallback;\n\n  return BrowserError.make({\n    operation,\n    reason: known.reason,\n    outcome: known.outcome ?? fallback.outcome,\n  });\n};\n\n/** Shared by the Playwright driver's seams, so every native call fails in the same vocabulary. */\nexport const failure = (reason: BrowserReason, outcome?: BrowserOutcome) =>\n  NativeFailure.make({ reason, ...(outcome === undefined ? {} : { outcome }) });\n\nexport const safeDecode = <A>(codec: Schema.Codec<A, unknown, never, never>, raw: unknown): A => {\n  const decoded = Schema.decodeUnknownExit(codec)(raw);\n\n  // A schema issue and a throw while reading the reply are both a malformed reply.\n  if (Exit.isFailure(decoded)) throw failure(Reasons.Malformed.make({}));\n\n  return decoded.value;\n};\n\n/**\n * No raw exception from Playwright crosses this private boundary. A ticket's own fence is\n * already a public error and passes through with the operation the owner gave it.\n */\nexport const sanitize = <A>(action: () => Promise<A>): Promise<A> =>\n  Promise.resolve()\n    .then(action)\n    .catch((error: unknown) => {\n      throw Schema.is(BrowserError)(error) || Schema.is(NativeFailure)(error)\n        ? error\n        : failure(Reasons.Provider.make({}));\n    });\n\nexport const closeWithin = async (\n  action: () => Promise<unknown>,\n  milliseconds = 2000,\n): Promise<void> => {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n\n  try {\n    await Promise.race([\n      Promise.resolve().then(action),\n      new Promise<never>((_, reject) => {\n        timer = setTimeout(() => reject(failure(Reasons.Timeout.make({}))), milliseconds);\n      }),\n    ]);\n  } finally {\n    clearTimeout(timer);\n  }\n};\n\n// The native timeout is finite as well as Effect's authoritative deadline. It cannot undo dispatch.\nexport const timeout = (ticket: ReadTicket) => {\n  ticket.check();\n\n  return ticket.remainingMillis();\n};\n","import { Reasons } from \"../../Errors.ts\";\nimport { failure } from \"./NativeCalls.ts\";\n\nconst malformed = () => failure(Reasons.Malformed.make({}));\n\n/** A checked read: a truncated segment is malformed framing, never `undefined` arithmetic. */\nconst byteAt = (bytes: Uint8Array, index: number): number => {\n  const byte = bytes[index];\n\n  if (byte === undefined) throw malformed();\n\n  return byte;\n};\n\n/** Parse framing only; a caller decoding media must still validate its complete bitstream. */\nexport const pngGeometry = (bytes: Uint8Array): { width: number; height: number } => {\n  const signature = [137, 80, 78, 71, 13, 10, 26, 10];\n\n  if (\n    bytes.length < 33 ||\n    signature.some((b, i) => bytes[i] !== b) ||\n    bytes[12] !== 73 ||\n    bytes[13] !== 72 ||\n    bytes[14] !== 68 ||\n    bytes[15] !== 82\n  )\n    throw malformed();\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n\n  if (view.getUint32(8) !== 13) throw malformed();\n\n  const width = view.getUint32(16),\n    height = view.getUint32(20);\n\n  if (width === 0 || height === 0) throw malformed();\n\n  return { width, height };\n};\n\n/** JPEG SOF dimensions avoid trusting the requested size or CSS viewport dimensions. */\nexport const jpegGeometry = (bytes: Uint8Array): { width: number; height: number } => {\n  if (bytes.length < 4 || bytes[0] !== 255 || bytes[1] !== 216) throw malformed();\n  let offset = 2;\n\n  while (offset + 3 < bytes.length) {\n    if (bytes[offset++] !== 255) throw malformed();\n    while (bytes[offset] === 255) offset++;\n    const marker = bytes[offset++];\n\n    if (marker === undefined || marker === 217 || marker === 218) break;\n    if (marker === 1 || (marker >= 208 && marker <= 215)) continue;\n    if (offset + 1 >= bytes.length) throw malformed();\n    const size = byteAt(bytes, offset) * 256 + byteAt(bytes, offset + 1);\n\n    if (size < 2 || offset + size > bytes.length) throw malformed();\n    if ([192, 193, 194, 195, 197, 198, 199, 201, 202, 203, 205, 206, 207].includes(marker)) {\n      if (size < 8) throw malformed();\n      const height = byteAt(bytes, offset + 3) * 256 + byteAt(bytes, offset + 4);\n      const width = byteAt(bytes, offset + 5) * 256 + byteAt(bytes, offset + 6);\n\n      if (width === 0 || height === 0) throw malformed();\n\n      return { width, height };\n    }\n    offset += size;\n  }\n  throw malformed();\n};\n","import type { Effect } from \"effect\";\n\nimport type { PageInfo, Target } from \"../../BrowserData.ts\";\nimport type { BrowserError } from \"../../Errors.ts\";\nimport type { CaptureSource } from \"./Driver.ts\";\nimport type { Owner, Ticket } from \"./Owner.ts\";\n\nexport interface CaptureLease {\n  readonly stop: Effect.Effect<void>;\n  readonly invalidate: (reason: string) => void;\n  readonly reservedBytes: number;\n}\n\nexport interface CaptureResolution {\n  /** Stable native page identity used to quarantine an unconfirmed screencast across reconnects. */\n  readonly key: string;\n  readonly target: Target;\n  readonly source: CaptureSource;\n}\n\nexport interface CaptureParent {\n  readonly owner: Owner;\n  readonly resolve: (\n    ticket: Ticket,\n    target?: PageInfo,\n  ) => Effect.Effect<CaptureResolution, BrowserError>;\n  readonly target: () => Target;\n  readonly captureLeases: Map<string, CaptureLease>;\n  captureReservedBytes: number;\n}\n\n// This is a private capability registry, not stored domain data. Exact live session identity is\n// required: spreading/cloning a session must not copy authority to mutate its capture owner,\n// leases or reservations. A public/enumerable parent field would weaken that boundary.\n// Keep this access centralized here; schemas describe data, never this mutable ownership state.\nconst parents = new WeakMap<object, CaptureParent>();\n\nexport const associate = (session: object, parent: CaptureParent): void => {\n  parents.set(session, parent);\n};\n\nexport const captureParent = (session: object): CaptureParent | undefined => parents.get(session);\n"],"mappings":"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"}