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

package/dist/Association-CH3kPHXE.mjs

@@ -1,167 +0,0 @@
-import { BrowserError, BrowserOutcome, Reasons } from "./Errors.mjs";
-import { Exit, Schema } from "effect";
-//#region src/internal/browser/NativeCalls.ts
-/**
-* A native step failed. It names no operation: the owner stamps the one the caller asked for
-* when it admits the work, so a step's own vocabulary can never become public API.
-*/
-var NativeFailure = class extends Schema.TaggedError()("NativeFailure", {
-	reason: BrowserError.fields.reason,
-	outcome: Schema.optionalKey(BrowserOutcome)
-}) {};
-/**
-* The only way a native failure becomes public. A fenced ticket already speaks publicly and
-* passes through with the operation the owner gave it; a native failure keeps its reason and
-* takes the caller's operation; anything else is the caller's fallback.
-*/
-const publicError = (error, operation, fallback) => {
-	if (Schema.is(BrowserError)(error)) return error;
-	const known = Schema.is(NativeFailure)(error) ? error : fallback;
-	return BrowserError.make({
-		operation,
-		reason: known.reason,
-		outcome: known.outcome ?? fallback.outcome
-	});
-};
-/** Shared by the Playwright driver's seams, so every native call fails in the same vocabulary. */
-const failure = (reason, outcome) => NativeFailure.make({
-	reason,
-	...outcome === void 0 ? {} : { outcome }
-});
-const safeDecode = (codec, raw) => {
-	const decoded = Schema.decodeUnknownExit(codec)(raw);
-	if (Exit.isFailure(decoded)) throw failure(Reasons.Malformed.make({}));
-	return decoded.value;
-};
-const escapes = /\u001b\[[0-9;]*m/g;
-const addresses = /\b[a-z][a-z0-9+.-]*:\/\/[^\s"'<>]*/gi;
-/**
-* An address keeps only its origin: a path, query or user name can carry a credential, such as
-* a DevTools endpoint's browser id or a provider's signed connection URL.
-*/
-const originOf = (address) => {
-	try {
-		const parsed = new URL(address);
-		return parsed.host === "" ? `${parsed.protocol}…` : `${parsed.protocol}//${parsed.host}/…`;
-	} catch {
-		return "…";
-	}
-};
-/**
-* The first line of what the engine said, which names the call and its reason. Playwright's
-* call log below it repeats addresses, selectors and endpoints, so it never leaves.
-*/
-const nativeDetail = (error) => {
-	const line = (error instanceof Error ? error.message : typeof error === "string" ? error : void 0)?.replace(escapes, "").split("\n", 1)[0]?.trim();
-	if (line === void 0 || line === "") return void 0;
-	return line.replace(addresses, originOf).slice(0, 512);
-};
-/** A raw failure the engine raised, with what it said about it. */
-const providerReason = (error) => {
-	const detail = nativeDetail(error);
-	return Reasons.Provider.make(detail === void 0 ? {} : { detail });
-};
-/**
-* No raw exception from Playwright crosses this private boundary: only its sanitized first line
-* does, as the provider reason's detail. A ticket's own fence is already a public error and
-* passes through with the operation the owner gave it.
-*/
-const sanitize = (action) => Promise.resolve().then(action).catch((error) => {
-	throw Schema.is(BrowserError)(error) || Schema.is(NativeFailure)(error) ? error : failure(providerReason(error));
-});
-const closeWithin = async (action, milliseconds = 2e3) => {
-	let timer;
-	try {
-		await Promise.race([Promise.resolve().then(action), new Promise((_, reject) => {
-			timer = setTimeout(() => reject(failure(Reasons.Timeout.make({}))), milliseconds);
-		})]);
-	} finally {
-		clearTimeout(timer);
-	}
-};
-const timeout = (ticket) => {
-	ticket.check();
-	return ticket.remainingMillis();
-};
-//#endregion
-//#region src/internal/browser/Images.ts
-const malformed = () => failure(Reasons.Malformed.make({}));
-/** A checked read: a truncated segment is malformed framing, never `undefined` arithmetic. */
-const byteAt = (bytes, index) => {
-	const byte = bytes[index];
-	if (byte === void 0) throw malformed();
-	return byte;
-};
-/** Parse framing only; a caller decoding media must still validate its complete bitstream. */
-const pngGeometry = (bytes) => {
-	if (bytes.length < 33 || [
-		137,
-		80,
-		78,
-		71,
-		13,
-		10,
-		26,
-		10
-	].some((b, i) => bytes[i] !== b) || bytes[12] !== 73 || bytes[13] !== 72 || bytes[14] !== 68 || bytes[15] !== 82) throw malformed();
-	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-	if (view.getUint32(8) !== 13) throw malformed();
-	const width = view.getUint32(16), height = view.getUint32(20);
-	if (width === 0 || height === 0) throw malformed();
-	return {
-		width,
-		height
-	};
-};
-/** JPEG SOF dimensions avoid trusting the requested size or CSS viewport dimensions. */
-const jpegGeometry = (bytes) => {
-	if (bytes.length < 4 || bytes[0] !== 255 || bytes[1] !== 216) throw malformed();
-	let offset = 2;
-	while (offset + 3 < bytes.length) {
-		if (bytes[offset++] !== 255) throw malformed();
-		while (bytes[offset] === 255) offset++;
-		const marker = bytes[offset++];
-		if (marker === void 0 || marker === 217 || marker === 218) break;
-		if (marker === 1 || marker >= 208 && marker <= 215) continue;
-		if (offset + 1 >= bytes.length) throw malformed();
-		const size = byteAt(bytes, offset) * 256 + byteAt(bytes, offset + 1);
-		if (size < 2 || offset + size > bytes.length) throw malformed();
-		if ([
-			192,
-			193,
-			194,
-			195,
-			197,
-			198,
-			199,
-			201,
-			202,
-			203,
-			205,
-			206,
-			207
-		].includes(marker)) {
-			if (size < 8) throw malformed();
-			const height = byteAt(bytes, offset + 3) * 256 + byteAt(bytes, offset + 4);
-			const width = byteAt(bytes, offset + 5) * 256 + byteAt(bytes, offset + 6);
-			if (width === 0 || height === 0) throw malformed();
-			return {
-				width,
-				height
-			};
-		}
-		offset += size;
-	}
-	throw malformed();
-};
-//#endregion
-//#region src/internal/browser/Association.ts
-const parents = /* @__PURE__ */ new WeakMap();
-const associate = (session, parent) => {
-	parents.set(session, parent);
-};
-const captureParent = (session) => parents.get(session);
-//#endregion
-export { NativeFailure as a, providerReason as c, sanitize as d, timeout as f, pngGeometry as i, publicError as l, captureParent as n, closeWithin as o, jpegGeometry as r, failure as s, associate as t, safeDecode as u };
-
-//# sourceMappingURL=Association-CH3kPHXE.mjs.map

package/dist/Association-CH3kPHXE.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Association-CH3kPHXE.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// oxlint-disable-next-line no-control-regex -- matches the terminal escape codes Playwright colours its call log with\nconst escapes = /\\u001b\\[[0-9;]*m/g;\n\nconst addresses = /\\b[a-z][a-z0-9+.-]*:\\/\\/[^\\s\"'<>]*/gi;\n\n/**\n * An address keeps only its origin: a path, query or user name can carry a credential, such as\n * a DevTools endpoint's browser id or a provider's signed connection URL.\n */\nconst originOf = (address: string): string => {\n  try {\n    const parsed = new URL(address);\n\n    return parsed.host === \"\" ? `${parsed.protocol}…` : `${parsed.protocol}//${parsed.host}/…`;\n  } catch {\n    return \"…\";\n  }\n};\n\n/**\n * The first line of what the engine said, which names the call and its reason. Playwright's\n * call log below it repeats addresses, selectors and endpoints, so it never leaves.\n */\nexport const nativeDetail = (error: unknown): string | undefined => {\n  const message =\n    error instanceof Error ? error.message : typeof error === \"string\" ? error : undefined;\n\n  const line = message?.replace(escapes, \"\").split(\"\\n\", 1)[0]?.trim();\n\n  if (line === undefined || line === \"\") return undefined;\n\n  return line.replace(addresses, originOf).slice(0, 512);\n};\n\n/** A raw failure the engine raised, with what it said about it. */\nexport const providerReason = (error: unknown) => {\n  const detail = nativeDetail(error);\n\n  return Reasons.Provider.make(detail === undefined ? {} : { detail });\n};\n\n/**\n * No raw exception from Playwright crosses this private boundary: only its sanitized first line\n * does, as the provider reason's detail. A ticket's own fence is already a public error and\n * 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(providerReason(error));\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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"}