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

package/dist/Association-BsSfBYVx.mjs

@@ -1,138 +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;
-};
-/**
-* No raw exception from Playwright crosses this private boundary. 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(Reasons.Provider.make({}));
-});
-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, publicError as c, timeout as d, pngGeometry as i, safeDecode as l, captureParent as n, closeWithin as o, jpegGeometry as r, failure as s, associate as t, sanitize as u };
-
-//# sourceMappingURL=Association-BsSfBYVx.mjs.map

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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"}