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

package/dist/Images-CaaPNeed.mjs

@@ -0,0 +1,76 @@
+import { Reasons } from "./Errors.mjs";
+import { y as failure } from "./PublicSession-Bs61Eal8.mjs";
+//#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
+export { pngGeometry as n, jpegGeometry as t };
+
+//# sourceMappingURL=Images-CaaPNeed.mjs.map

package/dist/Images-CaaPNeed.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Images-CaaPNeed.mjs","names":[],"sources":["../src/internal/browser/Images.ts"],"sourcesContent":["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"],"mappings":";;;AAGA,MAAM,kBAAkB,QAAQ,QAAQ,UAAU,KAAK,CAAC,CAAC,CAAC;;AAG1D,MAAM,UAAU,OAAmB,UAA0B;CAC3D,MAAM,OAAO,MAAM;CAEnB,IAAI,SAAS,KAAA,GAAW,MAAM,UAAU;CAExC,OAAO;AACT;;AAGA,MAAa,eAAe,UAAyD;CAGnF,IACE,MAAM,SAAS,MACf;EAJiB;EAAK;EAAI;EAAI;EAAI;EAAI;EAAI;EAAI;CAItC,CAAC,CAAC,MAAM,GAAG,MAAM,MAAM,OAAO,CAAC,KACvC,MAAM,QAAQ,MACd,MAAM,QAAQ,MACd,MAAM,QAAQ,MACd,MAAM,QAAQ,IAEd,MAAM,UAAU;CAClB,MAAM,OAAO,IAAI,SAAS,MAAM,QAAQ,MAAM,YAAY,MAAM,UAAU;CAE1E,IAAI,KAAK,UAAU,CAAC,MAAM,IAAI,MAAM,UAAU;CAE9C,MAAM,QAAQ,KAAK,UAAU,EAAE,GAC7B,SAAS,KAAK,UAAU,EAAE;CAE5B,IAAI,UAAU,KAAK,WAAW,GAAG,MAAM,UAAU;CAEjD,OAAO;EAAE;EAAO;CAAO;AACzB;;AAGA,MAAa,gBAAgB,UAAyD;CACpF,IAAI,MAAM,SAAS,KAAK,MAAM,OAAO,OAAO,MAAM,OAAO,KAAK,MAAM,UAAU;CAC9E,IAAI,SAAS;CAEb,OAAO,SAAS,IAAI,MAAM,QAAQ;EAChC,IAAI,MAAM,cAAc,KAAK,MAAM,UAAU;EAC7C,OAAO,MAAM,YAAY,KAAK;EAC9B,MAAM,SAAS,MAAM;EAErB,IAAI,WAAW,KAAA,KAAa,WAAW,OAAO,WAAW,KAAK;EAC9D,IAAI,WAAW,KAAM,UAAU,OAAO,UAAU,KAAM;EACtD,IAAI,SAAS,KAAK,MAAM,QAAQ,MAAM,UAAU;EAChD,MAAM,OAAO,OAAO,OAAO,MAAM,IAAI,MAAM,OAAO,OAAO,SAAS,CAAC;EAEnE,IAAI,OAAO,KAAK,SAAS,OAAO,MAAM,QAAQ,MAAM,UAAU;EAC9D,IAAI;GAAC;GAAK;GAAK;GAAK;GAAK;GAAK;GAAK;GAAK;GAAK;GAAK;GAAK;GAAK;GAAK;EAAG,CAAC,CAAC,SAAS,MAAM,GAAG;GACtF,IAAI,OAAO,GAAG,MAAM,UAAU;GAC9B,MAAM,SAAS,OAAO,OAAO,SAAS,CAAC,IAAI,MAAM,OAAO,OAAO,SAAS,CAAC;GACzE,MAAM,QAAQ,OAAO,OAAO,SAAS,CAAC,IAAI,MAAM,OAAO,OAAO,SAAS,CAAC;GAExE,IAAI,UAAU,KAAK,WAAW,GAAG,MAAM,UAAU;GAEjD,OAAO;IAAE;IAAO;GAAO;EACzB;EACA,UAAU;CACZ;CACA,MAAM,UAAU;AAClB"}

package/dist/OperationOptions-DAeRS6O9.mjs

@@ -0,0 +1,55 @@
+import { Duration, Option, Schema } from "effect";
+//#region src/internal/browser/OperationOptions.ts
+const FiniteDurationValue = Schema.Union([Schema.TaggedStruct("Millis", { millis: Schema.Finite }), Schema.TaggedStruct("Nanos", { nanos: Schema.BigInt })]);
+const FiniteDurationInput = Schema.Union([
+	Schema.Duration.check(Schema.makeFilter((duration) => Schema.is(FiniteDurationValue)(duration.value))),
+	Schema.Finite,
+	Schema.BigInt,
+	Schema.TemplateLiteral([
+		Schema.Finite,
+		" ",
+		Schema.Literals([
+			"nano",
+			"nanos",
+			"micro",
+			"micros",
+			"milli",
+			"millis",
+			"second",
+			"seconds",
+			"minute",
+			"minutes",
+			"hour",
+			"hours",
+			"day",
+			"days",
+			"week",
+			"weeks"
+		])
+	]),
+	Schema.Literals(["Infinity", "-Infinity"]),
+	Schema.Tuple([Schema.Finite, Schema.Finite]),
+	Schema.Struct({
+		weeks: Schema.optionalKey(Schema.Finite),
+		days: Schema.optionalKey(Schema.Finite),
+		hours: Schema.optionalKey(Schema.Finite),
+		minutes: Schema.optionalKey(Schema.Finite),
+		seconds: Schema.optionalKey(Schema.Finite),
+		milliseconds: Schema.optionalKey(Schema.Finite),
+		microseconds: Schema.optionalKey(Schema.Finite),
+		nanoseconds: Schema.optionalKey(Schema.Finite)
+	})
+]).check(Schema.makeFilter((input) => Option.exists(Duration.fromInput(input), (duration) => Duration.isFinite(duration) && !Duration.isNegative(duration) && Number.isFinite(Duration.toMillis(duration))), { message: "Queue duration must be finite and nonnegative" }));
+/** Host configuration only; never part of model-facing request schemas. */
+const AdmissionOptionsSchema = Schema.Struct({ queue: Schema.optionalKey(FiniteDurationInput) });
+const OperationOptionsSchema = Schema.Struct({
+	timeoutMillis: Schema.optionalKey(Schema.Int.check(Schema.isBetween({
+		minimum: 1,
+		maximum: 6e4
+	}))),
+	admission: Schema.optionalKey(AdmissionOptionsSchema)
+});
+//#endregion
+export { FiniteDurationInput as n, OperationOptionsSchema as r, AdmissionOptionsSchema as t };
+
+//# sourceMappingURL=OperationOptions-DAeRS6O9.mjs.map

package/dist/OperationOptions-DAeRS6O9.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationOptions-DAeRS6O9.mjs","names":[],"sources":["../src/internal/browser/OperationOptions.ts"],"sourcesContent":["import { Duration, Option, Schema } from \"effect\";\n\nconst FiniteDurationValue = Schema.Union([\n  Schema.TaggedStruct(\"Millis\", { millis: Schema.Finite }),\n  Schema.TaggedStruct(\"Nanos\", { nanos: Schema.BigInt }),\n]);\n\n// Duration.fromInput intentionally normalizes raw NaN to zero. Validate raw components first\n// so an invalid queue allowance cannot silently become fail-fast admission.\nexport const FiniteDurationInput = Schema.Union([\n  // The built-in declaration checks only the Duration marker. Validate its representation\n  // before arithmetic so a malformed host value is a typed refusal rather than a defect.\n  Schema.Duration.check(\n    Schema.makeFilter((duration) => Schema.is(FiniteDurationValue)(duration.value)),\n  ),\n  Schema.Finite,\n  Schema.BigInt,\n  Schema.TemplateLiteral([\n    Schema.Finite,\n    \" \",\n    Schema.Literals([\n      \"nano\",\n      \"nanos\",\n      \"micro\",\n      \"micros\",\n      \"milli\",\n      \"millis\",\n      \"second\",\n      \"seconds\",\n      \"minute\",\n      \"minutes\",\n      \"hour\",\n      \"hours\",\n      \"day\",\n      \"days\",\n      \"week\",\n      \"weeks\",\n    ]),\n  ]),\n  Schema.Literals([\"Infinity\", \"-Infinity\"]),\n  Schema.Tuple([Schema.Finite, Schema.Finite]),\n  Schema.Struct({\n    weeks: Schema.optionalKey(Schema.Finite),\n    days: Schema.optionalKey(Schema.Finite),\n    hours: Schema.optionalKey(Schema.Finite),\n    minutes: Schema.optionalKey(Schema.Finite),\n    seconds: Schema.optionalKey(Schema.Finite),\n    milliseconds: Schema.optionalKey(Schema.Finite),\n    microseconds: Schema.optionalKey(Schema.Finite),\n    nanoseconds: Schema.optionalKey(Schema.Finite),\n  }),\n]).check(\n  Schema.makeFilter(\n    (input) =>\n      Option.exists(\n        Duration.fromInput(input),\n        (duration) =>\n          Duration.isFinite(duration) &&\n          !Duration.isNegative(duration) &&\n          Number.isFinite(Duration.toMillis(duration)),\n      ),\n    { message: \"Queue duration must be finite and nonnegative\" },\n  ),\n);\n\n/** Host configuration only; never part of model-facing request schemas. */\nexport const AdmissionOptionsSchema = Schema.Struct({\n  queue: Schema.optionalKey(FiniteDurationInput),\n});\n\nexport const OperationOptionsSchema = Schema.Struct({\n  timeoutMillis: Schema.optionalKey(\n    Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 60000 })),\n  ),\n  admission: Schema.optionalKey(AdmissionOptionsSchema),\n});\n"],"mappings":";;AAEA,MAAM,sBAAsB,OAAO,MAAM,CACvC,OAAO,aAAa,UAAU,EAAE,QAAQ,OAAO,OAAO,CAAC,GACvD,OAAO,aAAa,SAAS,EAAE,OAAO,OAAO,OAAO,CAAC,CACvD,CAAC;AAID,MAAa,sBAAsB,OAAO,MAAM;CAG9C,OAAO,SAAS,MACd,OAAO,YAAY,aAAa,OAAO,GAAG,mBAAmB,CAAC,CAAC,SAAS,KAAK,CAAC,CAChF;CACA,OAAO;CACP,OAAO;CACP,OAAO,gBAAgB;EACrB,OAAO;EACP;EACA,OAAO,SAAS;GACd;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,CAAC;CACH,CAAC;CACD,OAAO,SAAS,CAAC,YAAY,WAAW,CAAC;CACzC,OAAO,MAAM,CAAC,OAAO,QAAQ,OAAO,MAAM,CAAC;CAC3C,OAAO,OAAO;EACZ,OAAO,OAAO,YAAY,OAAO,MAAM;EACvC,MAAM,OAAO,YAAY,OAAO,MAAM;EACtC,OAAO,OAAO,YAAY,OAAO,MAAM;EACvC,SAAS,OAAO,YAAY,OAAO,MAAM;EACzC,SAAS,OAAO,YAAY,OAAO,MAAM;EACzC,cAAc,OAAO,YAAY,OAAO,MAAM;EAC9C,cAAc,OAAO,YAAY,OAAO,MAAM;EAC9C,aAAa,OAAO,YAAY,OAAO,MAAM;CAC/C,CAAC;AACH,CAAC,CAAC,CAAC,MACD,OAAO,YACJ,UACC,OAAO,OACL,SAAS,UAAU,KAAK,IACvB,aACC,SAAS,SAAS,QAAQ,KAC1B,CAAC,SAAS,WAAW,QAAQ,KAC7B,OAAO,SAAS,SAAS,SAAS,QAAQ,CAAC,CAC/C,GACF,EAAE,SAAS,gDAAgD,CAC7D,CACF;;AAGA,MAAa,yBAAyB,OAAO,OAAO,EAClD,OAAO,OAAO,YAAY,mBAAmB,EAC/C,CAAC;AAED,MAAa,yBAAyB,OAAO,OAAO;CAClD,eAAe,OAAO,YACpB,OAAO,IAAI,MAAM,OAAO,UAAU;EAAE,SAAS;EAAG,SAAS;CAAM,CAAC,CAAC,CACnE;CACA,WAAW,OAAO,YAAY,sBAAsB;AACtD,CAAC"}

package/dist/PageControl.d.mts

@@ -1,14 +1,14 @@
 import { BrowserError } from "./Errors.mjs";
-import { M as PageExecutionState, N as PageInfo, P as PageSuspension } from "./BrowserData-DPh3Oaof.mjs";
-import { BrowserSession } from "./Browser.mjs";
+import { F as PageExecutionState, L as PageSuspension } from "./BrowserData-CPIIIHol.mjs";
+import { l as OperationOptions, u as Page } from "./Browser-n-bKgBNN.mjs";
 import { Effect } from "effect";
 //#region src/PageControl.d.ts
 /** Last acknowledged state; no remote guarantee survives connection loss or external control. */
-export declare const state: <E>(session: BrowserSession<E>, page: PageInfo) => Effect.Effect<PageExecutionState, BrowserError>;
-/** Explicit host-only hold requiring InteractiveOptions.pageControl; capture ACKs never invoke it. */
-export declare const suspend: <E>(session: BrowserSession<E>, page: PageInfo) => Effect.Effect<PageSuspension, BrowserError>;
+export declare const state: (page: Page, options?: OperationOptions) => Effect.Effect<PageExecutionState, BrowserError>;
+/** Explicit host-only hold requiring pageControl support; capture ACKs never invoke it. */
+export declare const suspend: (page: Page, options?: OperationOptions) => Effect.Effect<PageSuspension, BrowserError>;
 /** Consumes the exact live receipt. Activation is intentional; stale receipts never replay commands. */
-export declare const resume: <E>(session: BrowserSession<E>, receipt: PageSuspension) => Effect.Effect<void, BrowserError>;
+export declare const resume: (page: Page, receipt: PageSuspension, options?: OperationOptions) => Effect.Effect<void, BrowserError>;
 //#endregion
 export { PageExecutionState, PageSuspension };
 export {};

package/dist/PageControl.mjs

@@ -1,27 +1,33 @@
 import { BrowserError, Reasons } from "./Errors.mjs";
-import { PageExecutionState, PageInfo, PageSuspension } from "./BrowserData.mjs";
-import { n as pageControl } from "./PageControlAssociation-DabEg5AR.mjs";
+import { PageExecutionState, PageSuspension } from "./BrowserData.mjs";
+import { s as pageControl } from "./PageRegistry-B3q9DS3g.mjs";
+import { n as checkedOperationOptions } from "./PublicSession-Bs61Eal8.mjs";
 import { Effect, Schema } from "effect";
 //#region src/PageControl.ts
-const owner = (session) => Effect.suspend(() => {
-	const port = pageControl(session);
-	return port === void 0 ? Effect.fail(BrowserError.make({
+const owner = (page) => Effect.suspend(() => {
+	const association = pageControl(page);
+	return association === void 0 ? Effect.fail(BrowserError.make({
 		operation: "page-control",
 		reason: Reasons.UnregisteredSession.make({}),
 		outcome: "undispatched"
-	})) : Effect.succeed(port);
+	})) : Effect.succeed(association);
 });
 const invalid = () => BrowserError.make({
 	operation: "page-control",
 	reason: Reasons.Configuration.make({}),
 	outcome: "undispatched"
 });
+const requested = (page, options) => owner(page).pipe(Effect.flatMap((association) => checkedOperationOptions(options, "page-control").pipe(Effect.map((options) => ({
+	port: association.port,
+	page: association.page,
+	options
+})))));
 /** Last acknowledged state; no remote guarantee survives connection loss or external control. */
-const state = (session, page) => Schema.decodeEffect(PageInfo)(page).pipe(Effect.mapError(invalid), Effect.map((value) => Object.freeze(PageInfo.make({ ...value }))), Effect.flatMap((value) => owner(session).pipe(Effect.flatMap((port) => port.state(value)))));
-/** Explicit host-only hold requiring InteractiveOptions.pageControl; capture ACKs never invoke it. */
-const suspend = (session, page) => Schema.decodeEffect(PageInfo)(page).pipe(Effect.mapError(invalid), Effect.map((value) => Object.freeze(PageInfo.make({ ...value }))), Effect.flatMap((value) => owner(session).pipe(Effect.flatMap((port) => port.suspend(value)))));
+const state = (page, options) => requested(page, options).pipe(Effect.flatMap(({ port, page, options }) => port.state(page, options)));
+/** Explicit host-only hold requiring pageControl support; capture ACKs never invoke it. */
+const suspend = (page, options) => requested(page, options).pipe(Effect.flatMap(({ port, page, options }) => port.suspend(page, options)));
 /** Consumes the exact live receipt. Activation is intentional; stale receipts never replay commands. */
-const resume = (session, receipt) => Schema.decodeEffect(PageSuspension)(receipt).pipe(Effect.mapError(invalid), Effect.map((value) => Object.freeze(PageSuspension.make({ ...value }))), Effect.flatMap((value) => owner(session).pipe(Effect.flatMap((port) => port.resume(value)))));
+const resume = (page, receipt, options) => Schema.decodeEffect(PageSuspension)(receipt).pipe(Effect.mapError(invalid), Effect.map((value) => Object.freeze(PageSuspension.make({ ...value }))), Effect.flatMap((value) => owner(page).pipe(Effect.flatMap(({ port, page }) => page.pageId !== value.pageId || page.targetId !== value.targetId ? Effect.fail(invalid()) : checkedOperationOptions(options, "page-control").pipe(Effect.flatMap((options) => port.resume(value, options)))))));
 //#endregion
 export { PageExecutionState, PageSuspension, resume, state, suspend };
 

package/dist/PageControl.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"PageControl.mjs","names":[],"sources":["../src/PageControl.ts"],"sourcesContent":["import { Effect, Schema } from \"effect\";\n\nimport type { BrowserSession } from \"./Browser.ts\";\nimport { type PageExecutionState, PageInfo, PageSuspension } from \"./BrowserData.ts\";\nimport { BrowserError, Reasons } from \"./Errors.ts\";\nimport { pageControl } from \"./internal/browser/PageControlAssociation.ts\";\nexport { PageExecutionState, PageSuspension } from \"./BrowserData.ts\";\n\nconst owner = <E>(session: BrowserSession<E>) =>\n  Effect.suspend(() => {\n    const port = pageControl(session);\n\n    return port === undefined\n      ? Effect.fail(\n          BrowserError.make({\n            operation: \"page-control\",\n            reason: Reasons.UnregisteredSession.make({}),\n            outcome: \"undispatched\",\n          }),\n        )\n      : Effect.succeed(port);\n  });\n\nconst invalid = () =>\n  BrowserError.make({\n    operation: \"page-control\",\n    reason: Reasons.Configuration.make({}),\n    outcome: \"undispatched\",\n  });\n\n/** Last acknowledged state; no remote guarantee survives connection loss or external control. */\nexport const state = <E>(\n  session: BrowserSession<E>,\n  page: PageInfo,\n): Effect.Effect<PageExecutionState, BrowserError> =>\n  Schema.decodeEffect(PageInfo)(page).pipe(\n    Effect.mapError(invalid),\n    Effect.map((value) => Object.freeze(PageInfo.make({ ...value }))),\n    Effect.flatMap((value) => owner(session).pipe(Effect.flatMap((port) => port.state(value)))),\n  );\n\n/** Explicit host-only hold requiring InteractiveOptions.pageControl; capture ACKs never invoke it. */\nexport const suspend = <E>(\n  session: BrowserSession<E>,\n  page: PageInfo,\n): Effect.Effect<PageSuspension, BrowserError> =>\n  Schema.decodeEffect(PageInfo)(page).pipe(\n    Effect.mapError(invalid),\n    Effect.map((value) => Object.freeze(PageInfo.make({ ...value }))),\n    Effect.flatMap((value) => owner(session).pipe(Effect.flatMap((port) => port.suspend(value)))),\n  );\n\n/** Consumes the exact live receipt. Activation is intentional; stale receipts never replay commands. */\nexport const resume = <E>(\n  session: BrowserSession<E>,\n  receipt: PageSuspension,\n): Effect.Effect<void, BrowserError> =>\n  Schema.decodeEffect(PageSuspension)(receipt).pipe(\n    Effect.mapError(invalid),\n    Effect.map((value) => Object.freeze(PageSuspension.make({ ...value }))),\n    Effect.flatMap((value) => owner(session).pipe(Effect.flatMap((port) => port.resume(value)))),\n  );\n"],"mappings":";;;;;AAQA,MAAM,SAAY,YAChB,OAAO,cAAc;CACnB,MAAM,OAAO,YAAY,OAAO;CAEhC,OAAO,SAAS,KAAA,IACZ,OAAO,KACL,aAAa,KAAK;EAChB,WAAW;EACX,QAAQ,QAAQ,oBAAoB,KAAK,CAAC,CAAC;EAC3C,SAAS;CACX,CAAC,CACH,IACA,OAAO,QAAQ,IAAI;AACzB,CAAC;AAEH,MAAM,gBACJ,aAAa,KAAK;CAChB,WAAW;CACX,QAAQ,QAAQ,cAAc,KAAK,CAAC,CAAC;CACrC,SAAS;AACX,CAAC;;AAGH,MAAa,SACX,SACA,SAEA,OAAO,aAAa,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,KAClC,OAAO,SAAS,OAAO,GACvB,OAAO,KAAK,UAAU,OAAO,OAAO,SAAS,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,GAChE,OAAO,SAAS,UAAU,MAAM,OAAO,CAAC,CAAC,KAAK,OAAO,SAAS,SAAS,KAAK,MAAM,KAAK,CAAC,CAAC,CAAC,CAC5F;;AAGF,MAAa,WACX,SACA,SAEA,OAAO,aAAa,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,KAClC,OAAO,SAAS,OAAO,GACvB,OAAO,KAAK,UAAU,OAAO,OAAO,SAAS,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,GAChE,OAAO,SAAS,UAAU,MAAM,OAAO,CAAC,CAAC,KAAK,OAAO,SAAS,SAAS,KAAK,QAAQ,KAAK,CAAC,CAAC,CAAC,CAC9F;;AAGF,MAAa,UACX,SACA,YAEA,OAAO,aAAa,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,KAC3C,OAAO,SAAS,OAAO,GACvB,OAAO,KAAK,UAAU,OAAO,OAAO,eAAe,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,GACtE,OAAO,SAAS,UAAU,MAAM,OAAO,CAAC,CAAC,KAAK,OAAO,SAAS,SAAS,KAAK,OAAO,KAAK,CAAC,CAAC,CAAC,CAC7F"}
+{"version":3,"file":"PageControl.mjs","names":[],"sources":["../src/PageControl.ts"],"sourcesContent":["import { Effect, Schema } from \"effect\";\n\nimport type { OperationOptions, Page } from \"./Browser.ts\";\nimport { type PageExecutionState, PageSuspension } from \"./BrowserData.ts\";\nimport { BrowserError, Reasons } from \"./Errors.ts\";\nimport { pageControl } from \"./internal/browser/PageRegistry.ts\";\nimport { checkedOperationOptions } from \"./internal/browser/PublicSession.ts\";\nexport { PageExecutionState, PageSuspension } from \"./BrowserData.ts\";\n\nconst owner = (page: Page) =>\n  Effect.suspend(() => {\n    const association = pageControl(page);\n\n    return association === undefined\n      ? Effect.fail(\n          BrowserError.make({\n            operation: \"page-control\",\n            reason: Reasons.UnregisteredSession.make({}),\n            outcome: \"undispatched\",\n          }),\n        )\n      : Effect.succeed(association);\n  });\n\nconst invalid = () =>\n  BrowserError.make({\n    operation: \"page-control\",\n    reason: Reasons.Configuration.make({}),\n    outcome: \"undispatched\",\n  });\n\nconst requested = (page: Page, options?: OperationOptions) =>\n  owner(page).pipe(\n    Effect.flatMap((association) =>\n      checkedOperationOptions(options, \"page-control\").pipe(\n        Effect.map((options) => ({ port: association.port, page: association.page, options })),\n      ),\n    ),\n  );\n\n/** Last acknowledged state; no remote guarantee survives connection loss or external control. */\nexport const state = (\n  page: Page,\n  options?: OperationOptions,\n): Effect.Effect<PageExecutionState, BrowserError> =>\n  requested(page, options).pipe(\n    Effect.flatMap(({ port, page, options }) => port.state(page, options)),\n  );\n\n/** Explicit host-only hold requiring pageControl support; capture ACKs never invoke it. */\nexport const suspend = (\n  page: Page,\n  options?: OperationOptions,\n): Effect.Effect<PageSuspension, BrowserError> =>\n  requested(page, options).pipe(\n    Effect.flatMap(({ port, page, options }) => port.suspend(page, options)),\n  );\n\n/** Consumes the exact live receipt. Activation is intentional; stale receipts never replay commands. */\nexport const resume = (\n  page: Page,\n  receipt: PageSuspension,\n  options?: OperationOptions,\n): Effect.Effect<void, BrowserError> =>\n  Schema.decodeEffect(PageSuspension)(receipt).pipe(\n    Effect.mapError(invalid),\n    Effect.map((value) => Object.freeze(PageSuspension.make({ ...value }))),\n    Effect.flatMap((value) =>\n      owner(page).pipe(\n        Effect.flatMap(({ port, page }) =>\n          page.pageId !== value.pageId || page.targetId !== value.targetId\n            ? Effect.fail(invalid())\n            : checkedOperationOptions(options, \"page-control\").pipe(\n                Effect.flatMap((options) => port.resume(value, options)),\n              ),\n        ),\n      ),\n    ),\n  );\n"],"mappings":";;;;;;AASA,MAAM,SAAS,SACb,OAAO,cAAc;CACnB,MAAM,cAAc,YAAY,IAAI;CAEpC,OAAO,gBAAgB,KAAA,IACnB,OAAO,KACL,aAAa,KAAK;EAChB,WAAW;EACX,QAAQ,QAAQ,oBAAoB,KAAK,CAAC,CAAC;EAC3C,SAAS;CACX,CAAC,CACH,IACA,OAAO,QAAQ,WAAW;AAChC,CAAC;AAEH,MAAM,gBACJ,aAAa,KAAK;CAChB,WAAW;CACX,QAAQ,QAAQ,cAAc,KAAK,CAAC,CAAC;CACrC,SAAS;AACX,CAAC;AAEH,MAAM,aAAa,MAAY,YAC7B,MAAM,IAAI,CAAC,CAAC,KACV,OAAO,SAAS,gBACd,wBAAwB,SAAS,cAAc,CAAC,CAAC,KAC/C,OAAO,KAAK,aAAa;CAAE,MAAM,YAAY;CAAM,MAAM,YAAY;CAAM;AAAQ,EAAE,CACvF,CACF,CACF;;AAGF,MAAa,SACX,MACA,YAEA,UAAU,MAAM,OAAO,CAAC,CAAC,KACvB,OAAO,SAAS,EAAE,MAAM,MAAM,cAAc,KAAK,MAAM,MAAM,OAAO,CAAC,CACvE;;AAGF,MAAa,WACX,MACA,YAEA,UAAU,MAAM,OAAO,CAAC,CAAC,KACvB,OAAO,SAAS,EAAE,MAAM,MAAM,cAAc,KAAK,QAAQ,MAAM,OAAO,CAAC,CACzE;;AAGF,MAAa,UACX,MACA,SACA,YAEA,OAAO,aAAa,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,KAC3C,OAAO,SAAS,OAAO,GACvB,OAAO,KAAK,UAAU,OAAO,OAAO,eAAe,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,GACtE,OAAO,SAAS,UACd,MAAM,IAAI,CAAC,CAAC,KACV,OAAO,SAAS,EAAE,MAAM,WACtB,KAAK,WAAW,MAAM,UAAU,KAAK,aAAa,MAAM,WACpD,OAAO,KAAK,QAAQ,CAAC,IACrB,wBAAwB,SAAS,cAAc,CAAC,CAAC,KAC/C,OAAO,SAAS,YAAY,KAAK,OAAO,OAAO,OAAO,CAAC,CACzD,CACN,CACF,CACF,CACF"}

package/dist/PageRegistry-B3q9DS3g.mjs

@@ -0,0 +1,164 @@
+import { BrowserError, Reasons } from "./Errors.mjs";
+import { Deferred, Effect } from "effect";
+//#region src/internal/browser/PageRegistry.ts
+/**
+* The session's registered pages at their connection generations. Callers read the records; only
+* these transitions change them.
+*/
+const makePageRegistry = () => {
+	const pages = /* @__PURE__ */ new Map();
+	const owned = /* @__PURE__ */ new WeakMap();
+	const state = (record) => {
+		const found = owned.get(record);
+		if (found === void 0) throw new TypeError("Page record belongs to another registry");
+		return found;
+	};
+	return {
+		get: (pageId) => pages.get(pageId),
+		records: () => [...pages.values()],
+		/** Registers a page at a new generation, replacing any record of an earlier one. */
+		add: (init) => {
+			const record = {
+				identity: init.identity,
+				admission: init.admission,
+				info: init.info,
+				frames: /* @__PURE__ */ new Map(),
+				phase: init.paused ? "paused" : "open",
+				containment: { _tag: "NotRequired" },
+				store: init.store,
+				retirement: init.retirement,
+				get terminal() {
+					return init.terminal();
+				}
+			};
+			owned.set(record, record);
+			pages.set(init.info.pageId, record);
+			return record;
+		},
+		/** A popup/dialog policy holds an open page for its operator. */
+		pause: (pageId) => {
+			const page = pages.get(pageId);
+			if (page !== void 0 && page.phase === "open") page.phase = "paused";
+		},
+		/** The page is being closed: its issued authority refuses new work. */
+		closing: (pageId) => {
+			const page = pages.get(pageId);
+			if (page !== void 0 && page.phase !== "closed") page.phase = "closing";
+		},
+		/** The page closed: it settles its closure attempt and leaves the registry. */
+		closed: (pageId) => {
+			const page = pages.get(pageId);
+			if (page === void 0) return;
+			page.phase = "closed";
+			if (page.attempt !== void 0) Deferred.doneUnsafe(page.attempt, Effect.succeed(true));
+			pages.delete(pageId);
+		},
+		/** Records how an unknown outcome on this page was contained. */
+		contain: (record, containment) => {
+			state(record).containment = containment;
+		},
+		/** The native closure now in flight for this page. */
+		attempting: (record, attempt) => {
+			state(record).attempt = attempt;
+		},
+		/** The page's record of one frame, registered on first use. */
+		frame: (record, frameId) => {
+			const page = state(record);
+			const existing = page.frames.get(frameId);
+			if (existing !== void 0) return existing;
+			const frame = { detached: false };
+			page.frames.set(frameId, frame);
+			return frame;
+		},
+		/** A frame left its page: Frames issued for it are refused from now on. */
+		detachFrame: (pageId, frameId) => {
+			const page = pages.get(pageId);
+			const frame = page?.frames.get(frameId);
+			if (frame !== void 0) frame.detached = true;
+			page?.frames.delete(frameId);
+		},
+		clear: () => {
+			pages.clear();
+		}
+	};
+};
+const issued = /* @__PURE__ */ new WeakMap();
+const canonical = /* @__PURE__ */ new WeakMap();
+/** Registers a session's own capture parent under the session object itself. */
+const issueSession = (session, capture) => {
+	issued.set(session, {
+		_tag: "Session",
+		capture
+	});
+};
+/** The canonical Page for `record`: built by `make` and registered the first time only. */
+const issuePage = (record, make, authority) => {
+	const existing = canonical.get(record);
+	if (existing !== void 0) return existing;
+	const page = make();
+	const { controls, capture, pageControl } = authority();
+	canonical.set(record, page);
+	issued.set(page, {
+		_tag: "Page",
+		record,
+		controls,
+		capture,
+		pageControl: {
+			port: pageControl.port,
+			page: Object.freeze({ ...pageControl.page })
+		}
+	});
+	return page;
+};
+/** An issued Frame keeps its own exact controls and the owner of the session that issued it. */
+const issueFrame = (frame, owner, controls) => {
+	issued.set(frame, {
+		_tag: "Frame",
+		owner,
+		controls
+	});
+};
+const sessionOwner = (session) => {
+	const entry = issued.get(session);
+	return entry?._tag === "Session" ? entry.capture.owner : void 0;
+};
+/** The issued Page `page` is, if this exact object was issued by the session owning `owner`. */
+const issuedPageOf = (page, owner) => {
+	const entry = issued.get(page);
+	return entry?._tag === "Page" && entry.capture.owner === owner ? entry : void 0;
+};
+/** Capture binds only to original issued Page authority; a session association is insufficient. */
+const capturePageParent = (page) => {
+	const entry = issued.get(page);
+	return entry?._tag === "Page" ? entry.capture : void 0;
+};
+/** The page control an issued Page carries. */
+const pageControl = (page) => {
+	const entry = issued.get(page);
+	return entry?._tag === "Page" ? entry.pageControl : void 0;
+};
+const unregistered = (operation) => Effect.fail(BrowserError.make({
+	operation,
+	reason: Reasons.UnregisteredSession.make({}),
+	outcome: "undispatched"
+}));
+/** Provider bridges borrow the exact issued page on this session's original owner. */
+const resolvePageControlsForSession = (session, page, operation = "target") => Effect.suspend(() => {
+	const owner = sessionOwner(session);
+	const entry = owner === void 0 ? void 0 : issuedPageOf(page, owner);
+	return entry === void 0 ? unregistered(operation) : entry.controls.validate(operation).pipe(Effect.as(entry.controls));
+});
+/**
+* Tools borrow an exact issued Page, or an exact Frame one of its Pages issued, on this session's
+* original owner. Capture, page control and provider transfers stay Page-only.
+*/
+const resolveTargetControlsForSession = (session, target, operation = "target") => Effect.suspend(() => {
+	const entry = issued.get(target);
+	if (entry?._tag !== "Frame") return resolvePageControlsForSession(session, target, operation);
+	if (sessionOwner(session) !== entry.owner) return unregistered(operation);
+	return entry.controls.validate(operation).pipe(Effect.as(entry.controls));
+});
+//#endregion
+export { issuedPageOf as a, resolvePageControlsForSession as c, issueSession as i, resolveTargetControlsForSession as l, issueFrame as n, makePageRegistry as o, issuePage as r, pageControl as s, capturePageParent as t };
+
+//# sourceMappingURL=PageRegistry-B3q9DS3g.mjs.map

package/dist/PageRegistry-B3q9DS3g.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageRegistry-B3q9DS3g.mjs","names":[],"sources":["../src/internal/browser/PageRegistry.ts"],"sourcesContent":["import { Deferred, Effect } from \"effect\";\n\nimport type { OperationOptions, Page, PageStatus } from \"../../Browser.ts\";\nimport type { PageExecutionState, PageInfo, PageSuspension, Target } from \"../../BrowserData.ts\";\nimport { BrowserError, Reasons, type BrowserOperation } from \"../../Errors.ts\";\nimport type { Terminal } from \"../../TimelineData.ts\";\nimport type { makeRetirement } from \"../timeline/Retirement.ts\";\nimport type { makeStore } from \"../timeline/Store.ts\";\nimport type { AdmissionLane } from \"./Admission.ts\";\nimport type { CaptureParent, PageCaptureParent } from \"./Association.ts\";\nimport type { Owner } from \"./Owner.ts\";\nimport type { PageControls } from \"./Session.ts\";\n\n/** One frame of a registered page. Frames issued for a detached one are refused. */\nexport interface FrameRecord {\n  readonly detached: boolean;\n}\n\n/** The session's record of one registered page at one connection generation. */\nexport interface PageRecord {\n  readonly identity: Target;\n  readonly admission: AdmissionLane;\n  readonly info: PageInfo;\n  readonly frames: ReadonlyMap<string, FrameRecord>;\n  readonly phase: \"open\" | \"paused\" | \"closing\" | \"closed\";\n  readonly containment: PageStatus[\"containment\"];\n  readonly store: ReturnType<typeof makeStore>;\n  readonly terminal: Terminal | null;\n  readonly retirement: ReturnType<typeof makeRetirement>;\n  /** The native closure in flight for this page, settled true once it closed. */\n  readonly attempt?: Deferred.Deferred<boolean>;\n}\n\ninterface FrameState {\n  detached: boolean;\n}\n\ninterface RecordState {\n  readonly identity: Target;\n  readonly admission: AdmissionLane;\n  readonly info: PageInfo;\n  readonly frames: Map<string, FrameState>;\n  phase: PageRecord[\"phase\"];\n  containment: PageStatus[\"containment\"];\n  readonly store: ReturnType<typeof makeStore>;\n  readonly terminal: Terminal | null;\n  readonly retirement: ReturnType<typeof makeRetirement>;\n  attempt?: Deferred.Deferred<boolean>;\n}\n\n/**\n * The session's registered pages at their connection generations. Callers read the records; only\n * these transitions change them.\n */\nexport const makePageRegistry = () => {\n  const pages = new Map<string, RecordState>();\n  // Every record this registry made, by identity, including ones it no longer lists.\n  const owned = new WeakMap<PageRecord, RecordState>();\n\n  const state = (record: PageRecord): RecordState => {\n    const found = owned.get(record);\n\n    if (found === undefined) throw new TypeError(\"Page record belongs to another registry\");\n\n    return found;\n  };\n\n  return {\n    get: (pageId: string): PageRecord | undefined => pages.get(pageId),\n    records: (): ReadonlyArray<PageRecord> => [...pages.values()],\n    /** Registers a page at a new generation, replacing any record of an earlier one. */\n    add: (init: {\n      readonly identity: Target;\n      readonly admission: AdmissionLane;\n      readonly info: PageInfo;\n      readonly paused: boolean;\n      readonly store: ReturnType<typeof makeStore>;\n      readonly retirement: ReturnType<typeof makeRetirement>;\n      readonly terminal: () => Terminal | null;\n    }): PageRecord => {\n      const record: RecordState = {\n        identity: init.identity,\n        admission: init.admission,\n        info: init.info,\n        frames: new Map(),\n        phase: init.paused ? \"paused\" : \"open\",\n        containment: { _tag: \"NotRequired\" },\n        store: init.store,\n        retirement: init.retirement,\n        get terminal() {\n          return init.terminal();\n        },\n      };\n\n      owned.set(record, record);\n      pages.set(init.info.pageId, record);\n\n      return record;\n    },\n    /** A popup/dialog policy holds an open page for its operator. */\n    pause: (pageId: string) => {\n      const page = pages.get(pageId);\n\n      if (page !== undefined && page.phase === \"open\") page.phase = \"paused\";\n    },\n    /** The page is being closed: its issued authority refuses new work. */\n    closing: (pageId: string) => {\n      const page = pages.get(pageId);\n\n      if (page !== undefined && page.phase !== \"closed\") page.phase = \"closing\";\n    },\n    /** The page closed: it settles its closure attempt and leaves the registry. */\n    closed: (pageId: string) => {\n      const page = pages.get(pageId);\n\n      if (page === undefined) return;\n      page.phase = \"closed\";\n      if (page.attempt !== undefined) Deferred.doneUnsafe(page.attempt, Effect.succeed(true));\n      pages.delete(pageId);\n    },\n    /** Records how an unknown outcome on this page was contained. */\n    contain: (record: PageRecord, containment: PageStatus[\"containment\"]) => {\n      state(record).containment = containment;\n    },\n    /** The native closure now in flight for this page. */\n    attempting: (record: PageRecord, attempt: Deferred.Deferred<boolean>) => {\n      state(record).attempt = attempt;\n    },\n    /** The page's record of one frame, registered on first use. */\n    frame: (record: PageRecord, frameId: string): FrameRecord => {\n      const page = state(record);\n      const existing = page.frames.get(frameId);\n\n      if (existing !== undefined) return existing;\n      const frame: FrameState = { detached: false };\n\n      page.frames.set(frameId, frame);\n\n      return frame;\n    },\n    /** A frame left its page: Frames issued for it are refused from now on. */\n    detachFrame: (pageId: string, frameId: string) => {\n      const page = pages.get(pageId);\n      const frame = page?.frames.get(frameId);\n\n      if (frame !== undefined) frame.detached = true;\n      page?.frames.delete(frameId);\n    },\n    clear: () => {\n      pages.clear();\n    },\n  };\n};\n\nexport type PageRegistry = ReturnType<typeof makePageRegistry>;\n\nexport interface PageControlPort {\n  readonly state: (\n    page: PageInfo,\n    options?: OperationOptions,\n  ) => Effect.Effect<PageExecutionState, BrowserError>;\n  readonly suspend: (\n    page: PageInfo,\n    options?: OperationOptions,\n  ) => Effect.Effect<PageSuspension, BrowserError>;\n  readonly resume: (\n    receipt: PageSuspension,\n    options?: OperationOptions,\n  ) => Effect.Effect<void, BrowserError>;\n}\n\nexport interface PageControlAssociation {\n  readonly port: PageControlPort;\n  readonly page: PageInfo;\n}\n\n/** What one issued Page carries: its record, controls, capture parent and page control. */\nexport interface IssuedPage {\n  readonly record: PageRecord;\n  readonly controls: PageControls;\n  readonly capture: PageCaptureParent;\n  readonly pageControl: PageControlAssociation;\n}\n\ntype Issued =\n  | { readonly _tag: \"Session\"; readonly capture: CaptureParent }\n  | ({ readonly _tag: \"Page\" } & IssuedPage)\n  | { readonly _tag: \"Frame\"; readonly owner: Owner; readonly controls: PageControls };\n\n// This is a private capability registry, not stored domain data. Exact live identity is required:\n// spreading or cloning a session, Page or Frame must not copy authority over its owner, capture\n// leases, reservations or page control. A public or enumerable field would weaken that boundary.\n// Schemas describe data, never this mutable ownership state.\nconst issued = new WeakMap<object, Issued>();\n// One canonical Page per page record: issuing the same record again returns the same object.\nconst canonical = new WeakMap<PageRecord, Page>();\n\n/** Registers a session's own capture parent under the session object itself. */\nexport const issueSession = (session: object, capture: CaptureParent): void => {\n  issued.set(session, { _tag: \"Session\", capture });\n};\n\n/** The canonical Page for `record`: built by `make` and registered the first time only. */\nexport const issuePage = (\n  record: PageRecord,\n  make: () => Page,\n  authority: () => Omit<IssuedPage, \"record\">,\n): Page => {\n  const existing = canonical.get(record);\n\n  if (existing !== undefined) return existing;\n  const page = make();\n  const { controls, capture, pageControl } = authority();\n\n  canonical.set(record, page);\n  issued.set(page, {\n    _tag: \"Page\",\n    record,\n    controls,\n    capture,\n    pageControl: { port: pageControl.port, page: Object.freeze({ ...pageControl.page }) },\n  });\n\n  return page;\n};\n\n/** An issued Frame keeps its own exact controls and the owner of the session that issued it. */\nexport const issueFrame = (frame: object, owner: Owner, controls: PageControls): void => {\n  issued.set(frame, { _tag: \"Frame\", owner, controls });\n};\n\nconst sessionOwner = (session: object): Owner | undefined => {\n  const entry = issued.get(session);\n\n  return entry?._tag === \"Session\" ? entry.capture.owner : undefined;\n};\n\n/** The issued Page `page` is, if this exact object was issued by the session owning `owner`. */\nexport const issuedPageOf = (page: object, owner: Owner): IssuedPage | undefined => {\n  const entry = issued.get(page);\n\n  return entry?._tag === \"Page\" && entry.capture.owner === owner ? entry : undefined;\n};\n\n/** Capture binds only to original issued Page authority; a session association is insufficient. */\nexport const capturePageParent = (page: object): PageCaptureParent | undefined => {\n  const entry = issued.get(page);\n\n  return entry?._tag === \"Page\" ? entry.capture : undefined;\n};\n\n/** The page control an issued Page carries. */\nexport const pageControl = (page: object): PageControlAssociation | undefined => {\n  const entry = issued.get(page);\n\n  return entry?._tag === \"Page\" ? entry.pageControl : undefined;\n};\n\nconst unregistered = (operation: BrowserOperation) =>\n  Effect.fail(\n    BrowserError.make({\n      operation,\n      reason: Reasons.UnregisteredSession.make({}),\n      outcome: \"undispatched\",\n    }),\n  );\n\n/** Provider bridges borrow the exact issued page on this session's original owner. */\nexport const resolvePageControlsForSession = (\n  session: object,\n  page: object,\n  operation: BrowserOperation = \"target\",\n): Effect.Effect<PageControls, BrowserError> =>\n  Effect.suspend(() => {\n    const owner = sessionOwner(session);\n    const entry = owner === undefined ? undefined : issuedPageOf(page, owner);\n\n    return entry === undefined\n      ? unregistered(operation)\n      : entry.controls.validate(operation).pipe(Effect.as(entry.controls));\n  });\n\n/**\n * Tools borrow an exact issued Page, or an exact Frame one of its Pages issued, on this session's\n * original owner. Capture, page control and provider transfers stay Page-only.\n */\nexport const resolveTargetControlsForSession = (\n  session: object,\n  target: object,\n  operation: BrowserOperation = \"target\",\n): Effect.Effect<PageControls, BrowserError> =>\n  Effect.suspend(() => {\n    const entry = issued.get(target);\n\n    if (entry?._tag !== \"Frame\") return resolvePageControlsForSession(session, target, operation);\n    if (sessionOwner(session) !== entry.owner) return unregistered(operation);\n\n    return entry.controls.validate(operation).pipe(Effect.as(entry.controls));\n  });\n"],"mappings":"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"}