@archont561/qgis-sdk 0.3.0 → 0.5.0

package/dist/shared/chunk-wtv4vt4q.d.ts

@@ -0,0 +1,280 @@
+import { QgisSdkError2 } from "./chunk-pdj2fxjb.js";
+declare const MAX_SAFE_INTEGER2: number;
+declare const MIN_SAFE_INTEGER2: number;
+declare const PLUGIN_DESCRIPTION_SCHEMA_VERSION2: 1;
+type ValidationDirection2 = "request" | "result";
+interface SerializedValidationIssue2 {
+	readonly path: (string | number)[];
+	readonly code: string;
+}
+interface SerializedContractValidationError2 {
+	readonly code: string;
+	readonly direction: ValidationDirection2;
+	readonly issues: SerializedValidationIssue2[];
+}
+interface ActionDescription2 {
+	readonly id: string;
+	readonly title: string;
+	readonly handler: string;
+	readonly request: Readonly<Record<string, unknown>>;
+	readonly result: Readonly<Record<string, unknown>>;
+}
+/** The event kinds a stream may declare; the frame carries the same three. */
+type StreamEventKind2 = "data" | "progress" | "state";
+/**
+* A declared stream (decision-28): a request in, one payload schema per
+* declared event kind out. There is no `result`: the reply to a subscription is
+* the protocol's acknowledgement, not something an author declares.
+*/
+interface StreamDescription2 {
+	readonly id: string;
+	readonly title: string;
+	readonly handler: string;
+	readonly request: Readonly<Record<string, unknown>>;
+	readonly events: Readonly<Partial<Record<StreamEventKind2, Readonly<Record<string, unknown>>>>>;
+}
+interface PluginDescription2 {
+	readonly schema_version: 1;
+	readonly id: string;
+	readonly title: string;
+	readonly actions: readonly ActionDescription2[];
+	/** Declared streams; a description from a host that predates them is empty. */
+	readonly streams: readonly StreamDescription2[];
+}
+/**
+* Return whether `value` is a finite integer within the JavaScript-safe wire range.
+*/
+declare function isSafeJsonInteger2(value: unknown): value is number;
+/**
+* A declaration cannot be represented or parsed in the versioned contract.
+*/
+declare class QgisSdkDeclarationError2 extends QgisSdkError2 {
+	constructor(message: string);
+}
+/**
+* Safe, structured location and category for a rejected contract value.
+*/
+declare class QgisSdkValidationIssue2 {
+	readonly path: readonly (string | number)[];
+	readonly code: string;
+	constructor(path: readonly (string | number)[], code: string);
+	toJSON(): SerializedValidationIssue2;
+}
+/**
+* A request or result did not satisfy its declared wire contract.
+*/
+declare class QgisSdkContractValidationError2 extends QgisSdkError2 {
+	readonly direction: ValidationDirection2;
+	readonly issues: readonly QgisSdkValidationIssue2[];
+	constructor(direction: ValidationDirection2, issues: readonly QgisSdkValidationIssue2[]);
+	toJSON(): SerializedContractValidationError2;
+}
+/**
+* Parse and validate a version 1 `PluginDescription` emitted by `describe_plugin`.
+*/
+declare function parsePluginDescription2(input: string | Readonly<Record<string, unknown>>): PluginDescription2;
+declare const BRIDGE_PROTOCOL_VERSION2: 1;
+declare const MAX_CALL_ID_LENGTH2: number;
+/** A failure reply, as the host serialized it. */
+interface BridgeFailure2 {
+	readonly code: string;
+	readonly message: string;
+}
+/** A reply to one invocation: exactly one of `value` or `error` is present. */
+type InvokeReply2 = {
+	readonly protocol: 1;
+	readonly call_id: string;
+	readonly ok: true;
+	readonly value: unknown;
+} | {
+	readonly protocol: 1;
+	readonly call_id: string;
+	readonly ok: false;
+	readonly error: BridgeFailure2;
+};
+/** Why a subscription stopped. */
+type StreamTerminalKind2 = "complete" | "error" | "cancelled" | "gap" | "disposed";
+/** One event on a subscription. */
+interface BridgeStreamEvent2 {
+	readonly kind: StreamEventKind2;
+	readonly payload: unknown;
+}
+/** The end of a subscription, as the host described it. */
+interface BridgeStreamTerminal2 {
+	readonly kind: StreamTerminalKind2;
+	readonly message?: string;
+	readonly dropped?: number;
+}
+/** A frame carrying one event. */
+interface BridgeEventFrame2 {
+	readonly protocol: 1;
+	readonly subscription_id: string;
+	readonly seq: number;
+	readonly event: BridgeStreamEvent2;
+}
+/** The frame that ends a subscription. */
+interface BridgeTerminalFrame2 {
+	readonly protocol: 1;
+	readonly subscription_id: string;
+	readonly seq: number;
+	readonly terminal: BridgeStreamTerminal2;
+}
+/** Anything the host may send for a subscription. */
+type BridgeStreamFrame2 = BridgeEventFrame2 | BridgeTerminalFrame2;
+/** The transport a client speaks through; a QWebChannel adapter or a script. */
+interface WireTransport2 {
+	send(message: unknown): void;
+	subscribe(listener: (message: unknown) => void): () => void;
+}
+/** Options for {@link BridgeClient}. */
+interface BridgeClientOptions2 {
+	readonly timeoutMs?: number;
+}
+/** Options for one invocation. */
+interface InvokeOptions2 {
+	readonly signal?: AbortSignal;
+}
+/**
+* An envelope or reply does not match the versioned bridge protocol.
+*/
+declare class QgisSdkBridgeProtocolError2 extends QgisSdkError2 {
+	constructor(message: string);
+}
+/**
+* The host did not answer in time. The call may still have run, so this is an
+* unknown outcome: retrying automatically is forbidden, deciding is the caller's.
+*/
+declare class QgisSdkBridgeTimeoutError2 extends QgisSdkError2 {
+	readonly callId: string;
+	constructor(callId: string, timeoutMs: number);
+}
+/**
+* The caller aborted locally. Distinct from the host cancelling the operation,
+* which arrives as a failure reply carrying the `cancelled` code.
+*/
+declare class QgisSdkBridgeAbortedError2 extends QgisSdkError2 {
+	readonly callId: string;
+	constructor(callId: string);
+}
+/**
+* The client was closed, so pending calls can no longer be answered.
+*/
+declare class QgisSdkBridgeClosedError2 extends QgisSdkError2 {
+	constructor();
+}
+/**
+* A subscription's frames were not the sequence the host promised.
+*
+* The client does not try to reassemble: a missed frame is a fact about the
+* subscription, not something to paper over.
+*/
+declare class QgisSdkBridgeSequenceError2 extends QgisSdkError2 {
+	readonly subscriptionId: string;
+	readonly expected: number;
+	readonly received: number;
+	constructor(subscriptionId: string, expected: number, received: number);
+}
+/**
+* The subscription ended with a terminal frame the caller may want to inspect.
+*/
+declare class QgisSdkBridgeStreamEndedError2 extends QgisSdkError2 {
+	readonly subscriptionId: string;
+	readonly terminal: BridgeStreamTerminal2;
+	constructor(subscriptionId: string, terminal: BridgeStreamTerminal2);
+}
+/**
+* The host refused or failed the operation; `failure.code` is the contract.
+*/
+declare class QgisSdkBridgeRemoteError2 extends QgisSdkError2 {
+	readonly failure: BridgeFailure2;
+	readonly callId: string;
+	constructor(callId: string, failure: BridgeFailure2);
+}
+/**
+* Parse one reply, refusing anything the host could not legitimately have sent.
+*/
+declare function parseInvokeReply2(raw: unknown): InvokeReply2;
+/**
+* Parse one stream frame, refusing anything the host could not legitimately
+* have sent.
+*
+* Exactly one of `event` and `terminal` has to be present: a frame that carries
+* both leaves the client guessing which one wins, and a client that guesses is
+* a client that will eventually deliver an event after the end of a stream.
+*/
+declare function parseStreamFrame2(raw: unknown): BridgeStreamFrame2;
+/** Callbacks a subscription reports through. */
+interface SubscriptionHandlers2 {
+	readonly onEvent?: (event: BridgeStreamEvent2) => void;
+	readonly onTerminal?: (terminal: BridgeStreamTerminal2) => void;
+}
+/** A live subscription, as the caller holds it. */
+interface BridgeSubscription2 {
+	readonly id: string;
+	readonly closed: boolean;
+	close(): void;
+}
+/**
+* Correlate invocations with replies over an injected transport.
+*
+* The client never retries: a timeout, an abort and a closed client are three
+* different answers, and each is reported as itself.
+*/
+declare class BridgeClient2 {
+	private readonly transport;
+	private readonly timeoutMs;
+	private readonly pending;
+	private readonly subscriptions;
+	private readonly disposals;
+	private readonly unsubscribe;
+	private counter;
+	private closed;
+	private unmatched;
+	private breaks;
+	private lastProtocolError;
+	constructor(transport: WireTransport2, options?: BridgeClientOptions2);
+	/** Whether {@link close} has run; a closed client answers nothing. */
+	get isClosed(): boolean;
+	/** Replies that named no pending call: a late duplicate, or a stray message. */
+	get unmatchedReplies(): number;
+	/** Number of calls still waiting for a reply. */
+	get pendingCalls(): number;
+	/**
+	* Invoke one operation and settle with its value or with a typed failure.
+	*/
+	invoke(operation: string, payload?: Readonly<Record<string, unknown>>, options?: InvokeOptions2): Promise<unknown>;
+	/**
+	* Open a subscription and resolve once the host has acknowledged it.
+	*
+	* Frames are matched to the subscription by id and by sequence; a frame that
+	* does not continue the sequence ends the subscription instead of being
+	* delivered out of order.
+	*/
+	subscribe(operation: string, payload?: Readonly<Record<string, unknown>>, handlers?: SubscriptionHandlers2, options?: InvokeOptions2): Promise<BridgeSubscription2>;
+	/**
+	* Ask the host for the handshake: the contract this view may use.
+	*
+	* The host bound the view before its first message, so this is a call, not
+	* a binding. The value is what `Dispatcher.handshake` builds - protocol,
+	* generation, the plugin description, the host schema version and the
+	* operations this view is authorized for.
+	*/
+	handshake(options?: InvokeOptions2): Promise<unknown>;
+	/** Subscriptions still open; a leak check for callers and tests. */
+	get activeSubscriptions(): readonly string[];
+	/** Frames that did not continue their subscription's sequence. */
+	get sequenceBreaks(): number;
+	private send;
+	/**
+	* Refuse further calls, reject what is still pending, and stop listening.
+	*/
+	close(): void;
+	private settle;
+	private handle;
+	private handleFrame;
+	private endSubscription;
+	private disposeSubscription;
+	/** The last malformed message this client refused, if any. */
+	get protocolError(): Error | null;
+}
+export { MAX_SAFE_INTEGER2, MIN_SAFE_INTEGER2, PLUGIN_DESCRIPTION_SCHEMA_VERSION2, ValidationDirection2, SerializedValidationIssue2, SerializedContractValidationError2, ActionDescription2, StreamEventKind2, StreamDescription2, PluginDescription2, isSafeJsonInteger2, QgisSdkDeclarationError2, QgisSdkValidationIssue2, QgisSdkContractValidationError2, parsePluginDescription2, BRIDGE_PROTOCOL_VERSION2, MAX_CALL_ID_LENGTH2, BridgeFailure2, InvokeReply2, StreamTerminalKind2, BridgeStreamEvent2, BridgeStreamTerminal2, BridgeEventFrame2, BridgeTerminalFrame2, BridgeStreamFrame2, WireTransport2, BridgeClientOptions2, InvokeOptions2, QgisSdkBridgeProtocolError2, QgisSdkBridgeTimeoutError2, QgisSdkBridgeAbortedError2, QgisSdkBridgeClosedError2, QgisSdkBridgeSequenceError2, QgisSdkBridgeStreamEndedError2, QgisSdkBridgeRemoteError2, parseInvokeReply2, parseStreamFrame2, SubscriptionHandlers2, BridgeSubscription2, BridgeClient2 };

package/dist/svelte.d.ts

@@ -0,0 +1,75 @@
+import "./shared/chunk-wtv4vt4q.js";
+import "./shared/chunk-7tgzmz0m.js";
+import { OperationMap2, StreamMap2, QgisSdkCore2, QgisSdk2 } from "./shared/chunk-a33y575v.js";
+import { Store2, OperationState2, Operation2, OperationStore2, StreamTerminalLike2, StreamHandleLike2, StreamHandlersLike2, Stream2, StreamState2, StreamStore2, FormOptions2, FormStore2, HostQueryStore2 } from "./shared/chunk-3zscfm3y.js";
+import { QgisSdkError2 } from "./shared/chunk-pdj2fxjb.js";
+/** A helper was used outside the shape it needs. */
+declare class QgisSdkBridgeSvelteError extends QgisSdkError2 {
+	constructor(message: string);
+}
+/** The context key `setQgisSdk` writes and `getQgisSdk` reads. */
+declare const QGIS_SDK_CONTEXT: unique symbol;
+/**
+* Share a `QgisSdk` with the component subtree; call during component
+* initialisation. The SDK is shared as given and never closed here.
+*/
+declare function setQgisSdk<T extends QgisSdkCore2<unknown, unknown>>(qgis: T): T;
+/**
+* The `QgisSdk` the nearest `setQgisSdk` shared.
+*
+* The type parameters name the generated `Operations` and `Streams`; they are
+* the caller's claim, the same way the ancestor's argument was the page's.
+*/
+declare function getQgisSdk<
+	O = OperationMap2,
+	S = StreamMap2
+>(): QgisSdk2<O, S>;
+/**
+* An operation store whose in-flight call is aborted when the component is
+* destroyed; read it as `$op` or pass it to {@link toRune}.
+*/
+declare function operation<
+	I,
+	R
+>(operation: Operation2<I, R>): OperationStore2<I, R>;
+/**
+* A stream store closed when the component is destroyed. Pass the input now
+* or later with `store.setInput(...)`; `$effect(() => store.setInput(input))`
+* follows a reactive one, by content.
+*/
+declare function stream<
+	I,
+	E
+>(open: Stream2<I, E>, input?: I | null, handlers?: StreamHandlersLike2<E>): StreamStore2<I, E>;
+type RequestOf<
+	O,
+	K extends keyof O
+> = O[K] extends {
+	readonly request: infer Req;
+} ? Req : never;
+type ResultOf<
+	O,
+	K extends keyof O
+> = O[K] extends {
+	readonly result: infer Res;
+} ? Res : never;
+/**
+* The form of one declared action, disposed with the component: render
+* `form.fields`, bind `$form.values`, call `form.submit()`.
+*/
+declare function form<
+	O,
+	K extends keyof O & string
+>(qgis: QgisSdkCore2<O, unknown>, id: K, options?: FormOptions2): FormStore2<RequestOf<O, K> & object, ResultOf<O, K>>;
+/**
+* A host query store refreshed now (unless `auto` is `false`) and aborted
+* when the component is destroyed: `hostQuery(layersQuery(qgis))`.
+*/
+declare function hostQuery<T>(store: HostQueryStore2<T>, options?: {
+	readonly auto?: boolean;
+}): HostQueryStore2<T>;
+/** A runes-friendly view of any store: `const op = toRune(store); op.current`. */
+declare function toRune<T>(store: Store2<T>): {
+	readonly current: T;
+};
+export { Operation2 as Operation, OperationState2 as OperationState, QGIS_SDK_CONTEXT, QgisSdkBridgeSvelteError, Stream2 as Stream, StreamHandleLike2 as StreamHandleLike, StreamHandlersLike2 as StreamHandlersLike, StreamState2 as StreamState, StreamTerminalLike2 as StreamTerminalLike, form, getQgisSdk, hostQuery, operation, setQgisSdk, stream, toRune };

package/dist/svelte.js

@@ -0,0 +1,70 @@
+import"./shared/chunk-8gawbn19.js";
+import {
+  OperationStore2,
+  StreamStore2,
+  FormStore2
+} from "./shared/chunk-t1vpt5yq.js";
+import {
+  QgisSdkError2
+} from "./shared/chunk-2hwva3a3.js";
+
+// src/svelte.ts
+import { getContext, onDestroy, setContext } from "svelte";
+import { fromStore } from "svelte/store";
+class QgisSdkBridgeSvelteError extends QgisSdkError2 {
+  constructor(message) {
+    super(message, "svelte_binding");
+  }
+}
+var QGIS_SDK_CONTEXT = Symbol("qgis-sdk");
+function setQgisSdk(qgis) {
+  setContext(QGIS_SDK_CONTEXT, qgis);
+  return qgis;
+}
+function getQgisSdk() {
+  const qgis = getContext(QGIS_SDK_CONTEXT);
+  if (qgis === undefined) {
+    throw new QgisSdkBridgeSvelteError("getQgisSdk needs setQgisSdk in an ancestor component");
+  }
+  return qgis;
+}
+function operation(operation) {
+  const store = new OperationStore2(operation);
+  onDestroy(store.abort);
+  return store;
+}
+function stream(open, input = null, handlers = {}) {
+  const store = new StreamStore2(open, handlers);
+  store.setInput(input);
+  onDestroy(store.close);
+  return store;
+}
+function form(qgis, id, options) {
+  const store = new FormStore2(qgis, id, options);
+  onDestroy(() => store.dispose());
+  return store;
+}
+function hostQuery(store, options = {}) {
+  if (options.auto !== false) {
+    store.refresh();
+  }
+  onDestroy(store.abort);
+  return store;
+}
+function toRune(store) {
+  return fromStore(store);
+}
+export {
+  QGIS_SDK_CONTEXT,
+  QgisSdkBridgeSvelteError,
+  form,
+  getQgisSdk,
+  hostQuery,
+  operation,
+  setQgisSdk,
+  stream,
+  toRune
+};
+
+//# debugId=A88CE88B3B7681A364756E2164756E21
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsic3JjL3N2ZWx0ZS50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsKICAgICIvKipcbiAqIFRoaW4gU3ZlbHRlIDUgYmluZGluZ3Mgb3ZlciB0aGUgc3RvcmUgY29yZSAoZGVjaXNpb24tNDcpLlxuICpcbiAqIFRoaXMgZW50cnkgcG9pbnQgaXMgb3B0aW9uYWwgYW5kIGlzIHRoZSBvbmx5IG9uZSB0aGF0IGltcG9ydHMgU3ZlbHRlLiBUaGVcbiAqIHN0b3JlcyBpbiBgLi9zdG9yZXNgIGFscmVhZHkgc2F0aXNmeSBTdmVsdGUncyBzdG9yZSBjb250cmFjdCAtIGBzdWJzY3JpYmVgXG4gKiBjYWxscyBhdCBvbmNlIGFuZCBvbiBldmVyeSBjaGFuZ2UgYW5kIHJldHVybnMgdGhlIHVuc3Vic2NyaWJlciAtIHNvIGFcbiAqIGNvbXBvbmVudCB3cml0ZXMgYCRzdGF0ZWAgb3ZlciBhbnkgb2YgdGhlbSB3aXRoIG5vIHdyYXBwZXIuIFdoYXQgdGhpc1xuICogbW9kdWxlIGFkZHMgaXMgdGhlIGxpdHRsZSBTdmVsdGUgYXNrcyBmb3IgYXJvdW5kIHRoYXQ6XG4gKlxuICogLSBgc2V0UWdpc1Nka2AvYGdldFFnaXNTZGtgLCBvbmUgYFFnaXNTZGtgIHRocm91Z2ggY29tcG9uZW50IGNvbnRleHQ7XG4gKiAtIGZhY3RvcmllcyB0aGF0IHRpZSBhIHN0b3JlJ3MgbGlmZXRpbWUgdG8gdGhlIGNvbXBvbmVudCB0aGF0IG1hZGUgaXRcbiAqICAgKGBvbkRlc3Ryb3lgIGFib3J0cyBhIGNhbGwsIGNsb3NlcyBhIHN0cmVhbSwgZGlzcG9zZXMgYSBmb3JtKSwgd2hpY2ggYVxuICogICBiYXJlIGBuZXcgT3BlcmF0aW9uU3RvcmUoLi4uKWAgaW4gYSBgPHNjcmlwdD5gIHdvdWxkIG5vdDtcbiAqIC0gYHRvUnVuZWAsIGEgYCRzdGF0ZWAtZnJpZW5kbHkgYHsgY3VycmVudCB9YCBvdmVyIGFueSBzdG9yZSwgdGhyb3VnaFxuICogICBgZnJvbVN0b3JlYCBvZiBgc3ZlbHRlL3N0b3JlYCwgZm9yIGEgY29tcG9uZW50IHRoYXQgcHJlZmVycyBydW5lcy5cbiAqL1xuXG5pbXBvcnQgeyBnZXRDb250ZXh0LCBvbkRlc3Ryb3ksIHNldENvbnRleHQgfSBmcm9tIFwic3ZlbHRlXCI7XG5pbXBvcnQgeyBmcm9tU3RvcmUgfSBmcm9tIFwic3ZlbHRlL3N0b3JlXCI7XG5pbXBvcnQgeyBRZ2lzU2RrRXJyb3IgfSBmcm9tIFwiLi9lcnJvcnNcIjtcbmltcG9ydCB0eXBlIHsgUWdpc1NkaywgUWdpc1Nka0NvcmUgfSBmcm9tIFwiLi9xZ2lzLXNka1wiO1xuaW1wb3J0IHR5cGUgeyBPcGVyYXRpb25NYXAsIFN0cmVhbU1hcCB9IGZyb20gXCIuL3NjaGVtYVwiO1xuaW1wb3J0IHtcblx0dHlwZSBGb3JtT3B0aW9ucyxcblx0Rm9ybVN0b3JlLFxuXHR0eXBlIEhvc3RRdWVyeVN0b3JlLFxuXHR0eXBlIE9wZXJhdGlvbixcblx0T3BlcmF0aW9uU3RvcmUsXG5cdHR5cGUgU3RvcmUsXG5cdHR5cGUgU3RyZWFtLFxuXHR0eXBlIFN0cmVhbUhhbmRsZXJzTGlrZSxcblx0U3RyZWFtU3RvcmUsXG59IGZyb20gXCIuL3N0b3Jlc1wiO1xuXG5leHBvcnQgdHlwZSB7XG5cdE9wZXJhdGlvbixcblx0T3BlcmF0aW9uU3RhdGUsXG5cdFN0cmVhbSxcblx0U3RyZWFtSGFuZGxlTGlrZSxcblx0U3RyZWFtSGFuZGxlcnNMaWtlLFxuXHRTdHJlYW1TdGF0ZSxcblx0U3RyZWFtVGVybWluYWxMaWtlLFxufSBmcm9tIFwiLi9zdG9yZXNcIjtcblxuLyoqIEEgaGVscGVyIHdhcyB1c2VkIG91dHNpZGUgdGhlIHNoYXBlIGl0IG5lZWRzLiAqL1xuZXhwb3J0IGNsYXNzIFFnaXNTZGtCcmlkZ2VTdmVsdGVFcnJvciBleHRlbmRzIFFnaXNTZGtFcnJvciB7XG5cdHB1YmxpYyBjb25zdHJ1Y3RvcihtZXNzYWdlOiBzdHJpbmcpIHtcblx0XHRzdXBlcihtZXNzYWdlLCBcInN2ZWx0ZV9iaW5kaW5nXCIpO1xuXHR9XG59XG5cbi8qKiBUaGUgY29udGV4dCBrZXkgYHNldFFnaXNTZGtgIHdyaXRlcyBhbmQgYGdldFFnaXNTZGtgIHJlYWRzLiAqL1xuZXhwb3J0IGNvbnN0IFFHSVNfU0RLX0NPTlRFWFQ6IHVuaXF1ZSBzeW1ib2wgPSBTeW1ib2woXCJxZ2lzLXNka1wiKTtcblxuLyoqXG4gKiBTaGFyZSBhIGBRZ2lzU2RrYCB3aXRoIHRoZSBjb21wb25lbnQgc3VidHJlZTsgY2FsbCBkdXJpbmcgY29tcG9uZW50XG4gKiBpbml0aWFsaXNhdGlvbi4gVGhlIFNESyBpcyBzaGFyZWQgYXMgZ2l2ZW4gYW5kIG5ldmVyIGNsb3NlZCBoZXJlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gc2V0UWdpc1NkazxUIGV4dGVuZHMgUWdpc1Nka0NvcmU8dW5rbm93biwgdW5rbm93bj4+KFxuXHRxZ2lzOiBULFxuKTogVCB7XG5cdHNldENvbnRleHQoUUdJU19TREtfQ09OVEVYVCwgcWdpcyk7XG5cdHJldHVybiBxZ2lzO1xufVxuXG4vKipcbiAqIFRoZSBgUWdpc1Nka2AgdGhlIG5lYXJlc3QgYHNldFFnaXNTZGtgIHNoYXJlZC5cbiAqXG4gKiBUaGUgdHlwZSBwYXJhbWV0ZXJzIG5hbWUgdGhlIGdlbmVyYXRlZCBgT3BlcmF0aW9uc2AgYW5kIGBTdHJlYW1zYDsgdGhleSBhcmVcbiAqIHRoZSBjYWxsZXIncyBjbGFpbSwgdGhlIHNhbWUgd2F5IHRoZSBhbmNlc3RvcidzIGFyZ3VtZW50IHdhcyB0aGUgcGFnZSdzLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0UWdpc1NkazxPID0gT3BlcmF0aW9uTWFwLCBTID0gU3RyZWFtTWFwPigpOiBRZ2lzU2RrPE8sIFM+IHtcblx0Y29uc3QgcWdpcyA9IGdldENvbnRleHQ8UWdpc1Nka0NvcmU8dW5rbm93biwgdW5rbm93bj4gfCB1bmRlZmluZWQ+KFxuXHRcdFFHSVNfU0RLX0NPTlRFWFQsXG5cdCk7XG5cdGlmIChxZ2lzID09PSB1bmRlZmluZWQpIHtcblx0XHR0aHJvdyBuZXcgUWdpc1Nka0JyaWRnZVN2ZWx0ZUVycm9yKFxuXHRcdFx0XCJnZXRRZ2lzU2RrIG5lZWRzIHNldFFnaXNTZGsgaW4gYW4gYW5jZXN0b3IgY29tcG9uZW50XCIsXG5cdFx0KTtcblx0fVxuXHRyZXR1cm4gcWdpcyBhcyB1bmtub3duIGFzIFFnaXNTZGs8TywgUz47XG59XG5cbi8qKlxuICogQW4gb3BlcmF0aW9uIHN0b3JlIHdob3NlIGluLWZsaWdodCBjYWxsIGlzIGFib3J0ZWQgd2hlbiB0aGUgY29tcG9uZW50IGlzXG4gKiBkZXN0cm95ZWQ7IHJlYWQgaXQgYXMgYCRvcGAgb3IgcGFzcyBpdCB0byB7QGxpbmsgdG9SdW5lfS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG9wZXJhdGlvbjxJLCBSPihcblx0b3BlcmF0aW9uOiBPcGVyYXRpb248SSwgUj4sXG4pOiBPcGVyYXRpb25TdG9yZTxJLCBSPiB7XG5cdGNvbnN0IHN0b3JlID0gbmV3IE9wZXJhdGlvblN0b3JlKG9wZXJhdGlvbik7XG5cdG9uRGVzdHJveShzdG9yZS5hYm9ydCk7XG5cdHJldHVybiBzdG9yZTtcbn1cblxuLyoqXG4gKiBBIHN0cmVhbSBzdG9yZSBjbG9zZWQgd2hlbiB0aGUgY29tcG9uZW50IGlzIGRlc3Ryb3llZC4gUGFzcyB0aGUgaW5wdXQgbm93XG4gKiBvciBsYXRlciB3aXRoIGBzdG9yZS5zZXRJbnB1dCguLi4pYDsgYCRlZmZlY3QoKCkgPT4gc3RvcmUuc2V0SW5wdXQoaW5wdXQpKWBcbiAqIGZvbGxvd3MgYSByZWFjdGl2ZSBvbmUsIGJ5IGNvbnRlbnQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzdHJlYW08SSwgRT4oXG5cdG9wZW46IFN0cmVhbTxJLCBFPixcblx0aW5wdXQ6IEkgfCBudWxsID0gbnVsbCxcblx0aGFuZGxlcnM6IFN0cmVhbUhhbmRsZXJzTGlrZTxFPiA9IHt9LFxuKTogU3RyZWFtU3RvcmU8SSwgRT4ge1xuXHRjb25zdCBzdG9yZSA9IG5ldyBTdHJlYW1TdG9yZShvcGVuLCBoYW5kbGVycyk7XG5cdHN0b3JlLnNldElucHV0KGlucHV0KTtcblx0b25EZXN0cm95KHN0b3JlLmNsb3NlKTtcblx0cmV0dXJuIHN0b3JlO1xufVxuXG50eXBlIFJlcXVlc3RPZjxPLCBLIGV4dGVuZHMga2V5b2YgTz4gPSBPW0tdIGV4dGVuZHMge1xuXHRyZWFkb25seSByZXF1ZXN0OiBpbmZlciBSZXE7XG59XG5cdD8gUmVxXG5cdDogbmV2ZXI7XG50eXBlIFJlc3VsdE9mPE8sIEsgZXh0ZW5kcyBrZXlvZiBPPiA9IE9bS10gZXh0ZW5kcyB7XG5cdHJlYWRvbmx5IHJlc3VsdDogaW5mZXIgUmVzO1xufVxuXHQ/IFJlc1xuXHQ6IG5ldmVyO1xuXG4vKipcbiAqIFRoZSBmb3JtIG9mIG9uZSBkZWNsYXJlZCBhY3Rpb24sIGRpc3Bvc2VkIHdpdGggdGhlIGNvbXBvbmVudDogcmVuZGVyXG4gKiBgZm9ybS5maWVsZHNgLCBiaW5kIGAkZm9ybS52YWx1ZXNgLCBjYWxsIGBmb3JtLnN1Ym1pdCgpYC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGZvcm08TywgSyBleHRlbmRzIGtleW9mIE8gJiBzdHJpbmc+KFxuXHRxZ2lzOiBRZ2lzU2RrQ29yZTxPLCB1bmtub3duPixcblx0aWQ6IEssXG5cdG9wdGlvbnM/OiBGb3JtT3B0aW9ucyxcbik6IEZvcm1TdG9yZTxSZXF1ZXN0T2Y8TywgSz4gJiBvYmplY3QsIFJlc3VsdE9mPE8sIEs+PiB7XG5cdGNvbnN0IHN0b3JlID0gbmV3IEZvcm1TdG9yZTxSZXF1ZXN0T2Y8TywgSz4gJiBvYmplY3QsIFJlc3VsdE9mPE8sIEs+Pihcblx0XHRxZ2lzIGFzIFFnaXNTZGtDb3JlPHVua25vd24sIHVua25vd24+LFxuXHRcdGlkLFxuXHRcdG9wdGlvbnMsXG5cdCk7XG5cdG9uRGVzdHJveSgoKSA9PiBzdG9yZS5kaXNwb3NlKCkpO1xuXHRyZXR1cm4gc3RvcmU7XG59XG5cbi8qKlxuICogQSBob3N0IHF1ZXJ5IHN0b3JlIHJlZnJlc2hlZCBub3cgKHVubGVzcyBgYXV0b2AgaXMgYGZhbHNlYCkgYW5kIGFib3J0ZWRcbiAqIHdoZW4gdGhlIGNvbXBvbmVudCBpcyBkZXN0cm95ZWQ6IGBob3N0UXVlcnkobGF5ZXJzUXVlcnkocWdpcykpYC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGhvc3RRdWVyeTxUPihcblx0c3RvcmU6IEhvc3RRdWVyeVN0b3JlPFQ+LFxuXHRvcHRpb25zOiB7IHJlYWRvbmx5IGF1dG8/OiBib29sZWFuIH0gPSB7fSxcbik6IEhvc3RRdWVyeVN0b3JlPFQ+IHtcblx0aWYgKG9wdGlvbnMuYXV0byAhPT0gZmFsc2UpIHtcblx0XHR2b2lkIHN0b3JlLnJlZnJlc2goKTtcblx0fVxuXHRvbkRlc3Ryb3koc3RvcmUuYWJvcnQpO1xuXHRyZXR1cm4gc3RvcmU7XG59XG5cbi8qKiBBIHJ1bmVzLWZyaWVuZGx5IHZpZXcgb2YgYW55IHN0b3JlOiBgY29uc3Qgb3AgPSB0b1J1bmUoc3RvcmUpOyBvcC5jdXJyZW50YC4gKi9cbmV4cG9ydCBmdW5jdGlvbiB0b1J1bmU8VD4oc3RvcmU6IFN0b3JlPFQ+KTogeyByZWFkb25seSBjdXJyZW50OiBUIH0ge1xuXHRyZXR1cm4gZnJvbVN0b3JlKHN0b3JlKTtcbn1cbiIKICBdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7O0FBaUJBO0FBQ0E7QUEyQk8sTUFBTSxpQ0FBaUMsY0FBYTtBQUFBLEVBQ25ELFdBQVcsQ0FBQyxTQUFpQjtBQUFBLElBQ25DLE1BQU0sU0FBUyxnQkFBZ0I7QUFBQTtBQUVqQztBQUdPLElBQU0sbUJBQWtDLE9BQU8sVUFBVTtBQU16RCxTQUFTLFVBQW1ELENBQ2xFLE1BQ0k7QUFBQSxFQUNKLFdBQVcsa0JBQWtCLElBQUk7QUFBQSxFQUNqQyxPQUFPO0FBQUE7QUFTRCxTQUFTLFVBQTJDLEdBQWtCO0FBQUEsRUFDNUUsTUFBTSxPQUFPLFdBQ1osZ0JBQ0Q7QUFBQSxFQUNBLElBQUksU0FBUyxXQUFXO0FBQUEsSUFDdkIsTUFBTSxJQUFJLHlCQUNULHNEQUNEO0FBQUEsRUFDRDtBQUFBLEVBQ0EsT0FBTztBQUFBO0FBT0QsU0FBUyxTQUFlLENBQzlCLFdBQ3VCO0FBQUEsRUFDdkIsTUFBTSxRQUFRLElBQUksZ0JBQWUsU0FBUztBQUFBLEVBQzFDLFVBQVUsTUFBTSxLQUFLO0FBQUEsRUFDckIsT0FBTztBQUFBO0FBUUQsU0FBUyxNQUFZLENBQzNCLE1BQ0EsUUFBa0IsTUFDbEIsV0FBa0MsQ0FBQyxHQUNmO0FBQUEsRUFDcEIsTUFBTSxRQUFRLElBQUksYUFBWSxNQUFNLFFBQVE7QUFBQSxFQUM1QyxNQUFNLFNBQVMsS0FBSztBQUFBLEVBQ3BCLFVBQVUsTUFBTSxLQUFLO0FBQUEsRUFDckIsT0FBTztBQUFBO0FBa0JELFNBQVMsSUFBbUMsQ0FDbEQsTUFDQSxJQUNBLFNBQ3NEO0FBQUEsRUFDdEQsTUFBTSxRQUFRLElBQUksV0FDakIsTUFDQSxJQUNBLE9BQ0Q7QUFBQSxFQUNBLFVBQVUsTUFBTSxNQUFNLFFBQVEsQ0FBQztBQUFBLEVBQy9CLE9BQU87QUFBQTtBQU9ELFNBQVMsU0FBWSxDQUMzQixPQUNBLFVBQXVDLENBQUMsR0FDcEI7QUFBQSxFQUNwQixJQUFJLFFBQVEsU0FBUyxPQUFPO0FBQUEsSUFDdEIsTUFBTSxRQUFRO0FBQUEsRUFDcEI7QUFBQSxFQUNBLFVBQVUsTUFBTSxLQUFLO0FBQUEsRUFDckIsT0FBTztBQUFBO0FBSUQsU0FBUyxNQUFTLENBQUMsT0FBMEM7QUFBQSxFQUNuRSxPQUFPLFVBQVUsS0FBSztBQUFBOyIsCiAgImRlYnVnSWQiOiAiQTg4Q0U4OEIzQjc2ODFBMzY0NzU2RTIxNjQ3NTZFMjEiLAogICJuYW1lcyI6IFtdCn0=

package/dist/testing.d.ts

@@ -1,25 +1,7 @@
-/**
-* Base class for expected SDK errors across the bridge boundary.
-*/
-declare class QgisSdkError extends Error {
-	readonly code: string;
-	constructor(message: string, code?: string);
-}
-/** The kinds of event a stream may carry; only `progress` may be coalesced. */
-type StreamEventKind2 = "data" | "progress" | "state";
-/** Why a subscription stopped. */
-type StreamTerminalKind = "complete" | "error" | "cancelled" | "gap" | "disposed";
-/** The end of a subscription, as the host described it. */
-interface BridgeStreamTerminal {
-	readonly kind: StreamTerminalKind;
-	readonly message?: string;
-	readonly dropped?: number;
-}
-/** The transport a client speaks through; a QWebChannel adapter or a script. */
-interface WireTransport {
-	send(message: unknown): void;
-	subscribe(listener: (message: unknown) => void): () => void;
-}
+import { StreamEventKind2, BridgeStreamTerminal2, WireTransport2 } from "./shared/chunk-wtv4vt4q.js";
+import { HostOperationId2 } from "./shared/chunk-7tgzmz0m.js";
+import { OperationShape2, StreamShape2, BridgeSchema2, QgisSdkHostTheme2 } from "./shared/chunk-a33y575v.js";
+import { QgisSdkError2 } from "./shared/chunk-pdj2fxjb.js";
 /** A scripted host failure, returned from an expectation's handler. */
 interface ScriptedFault {
 	readonly fault: {
@@ -43,7 +25,8 @@ type ScriptedReply<Res> = Res | ScriptedFault | typeof SILENCE | Promise<Res | S
 /** A message the client sent, as the harness recorded it. */
 interface RecordedCall {
 	readonly callId: string;
-	readonly kind: "invoke" | "subscribe" | "unsubscribe";
+	readonly kind: "invoke" | "subscribe" | "unsubscribe" | "handshake";
+	/** Empty for a handshake, which names no operation. */
 	readonly operation: string;
 	readonly payload?: Readonly<Record<string, unknown>>;
 	readonly subscriptionId?: string;
@@ -58,7 +41,7 @@ interface ScriptedStream {
 	/** `false` once the host ended it or the page closed it. */
 	readonly open: boolean;
 	emit(kind: StreamEventKind2, payload: unknown): void;
-	end(terminal: BridgeStreamTerminal): void;
+	end(terminal: BridgeStreamTerminal2): void;
 	/** Advance the sequence without sending, so the next frame is a gap. */
 	skip(frames: number): void;
 }
@@ -67,15 +50,32 @@ interface SubscribeOptions {
 	/** Delay the acknowledgement until this promise settles. */
 	readonly ack?: () => Promise<void>;
 }
+/** Options for {@link createBridgeHarness}. */
+interface HarnessOptions {
+	/**
+	* The host operation ids the scripted handshake advertises; every curated
+	* id by default. A narrowed list is how a test proves a page respects
+	* `qgis.host.granted`. A call outside it is still answered
+	* by whatever the test scripted - typically `fault("not_authorized", ...)` -
+	* because that refusal is the host's, not the harness's.
+	*/
+	readonly granted?: readonly HostOperationId2[];
+	/**
+	* The palette the scripted handshake carries as `theme`; none by default,
+	* which is what a page outside QGIS sees. The same shape the WebEngine
+	* adapter sends, so a test can prove a page takes the host's colours.
+	*/
+	readonly theme?: QgisSdkHostTheme2;
+}
 /**
 * A test's script went wrong: an unmet or unexpected call, a leaked
 * subscription, a handler that threw, or an envelope that is not protocol 1.
 */
-declare class QgisSdkBridgeHarnessError extends QgisSdkError {
+declare class QgisSdkBridgeHarnessError extends QgisSdkError2 {
 	constructor(message: string);
 }
 /** The harness a test holds; also the transport its client is built on. */
-interface BridgeHarness<Op extends string = string> extends WireTransport {
+interface BridgeHarness<Op extends string = string> extends WireTransport2 {
 	/** Every message the client sent, in order. */
 	readonly calls: readonly RecordedCall[];
 	/** Calls no expectation covered; each was answered `unexpected_call`. */
@@ -102,8 +102,36 @@ interface BridgeHarness<Op extends string = string> extends WireTransport {
 	assertSatisfied(): void;
 }
 /**
-* Create a harness; `Op` narrows the operations a test may expect, typically
-* the generated module's `OperationId`.
+* The harness {@link createBridgeHarness} returns for a schema: the same
+* harness, with `expectInvoke` and `expectSubscribe` typed by the schema's
+* `Operations` and `Streams` - a payload is the declared request, a reply the
+* declared result - and by the curated host ids, whose shapes the host module
+* owns.
+*/
+interface SchemaBridgeHarness<
+	O,
+	S
+> extends Omit<BridgeHarness<Extract<keyof O | keyof S, string> | HostOperationId2>, "expectInvoke" | "expectSubscribe"> {
+	expectInvoke<K extends Extract<keyof O, string>>(operation: K, handler: (payload: O[K] extends OperationShape2 ? O[K]["request"] : never) => ScriptedReply<O[K] extends OperationShape2 ? O[K]["result"] : never>): void;
+	expectInvoke<
+		Req extends object = Readonly<Record<string, unknown>>,
+		Res = unknown
+	>(operation: HostOperationId2, handler: (payload: Req) => ScriptedReply<Res>): void;
+	expectSubscribe<K extends Extract<keyof S, string>>(operation: K, script: SubscribeScript<S[K] extends StreamShape2 ? S[K]["request"] : never>, options?: SubscribeOptions): void;
+	expectSubscribe<Req extends object = Readonly<Record<string, unknown>>>(operation: HostOperationId2, script: SubscribeScript<Req>, options?: SubscribeOptions): void;
+}
+/**
+* Create a harness.
+*
+* Given the generated `bridge.schema.ts` default export, the harness is typed
+* by it: `expectInvoke("sites.summary", (payload) => ...)` sees the declared
+* request and must answer with the declared result, and the handshake it
+* answers advertises the schema's operations. Without one, `Op` narrows the
+* operations a test may expect, typically a generated `OperationId`.
 */
-declare function createBridgeHarness<Op extends string = string>(): BridgeHarness<Op>;
-export { BridgeHarness, QgisSdkBridgeHarnessError, RecordedCall, SILENCE, ScriptedFault, ScriptedRefusal, ScriptedReply, ScriptedStream, SubscribeOptions, SubscribeScript, createBridgeHarness, fault };
+declare function createBridgeHarness<Op extends string = string>(options?: HarnessOptions): BridgeHarness<Op>;
+declare function createBridgeHarness<
+	O,
+	S
+>(schema: BridgeSchema2<O, S>, options?: HarnessOptions): SchemaBridgeHarness<O, S>;
+export { BridgeHarness, HarnessOptions, QgisSdkBridgeHarnessError, RecordedCall, SILENCE, SchemaBridgeHarness, ScriptedFault, ScriptedRefusal, ScriptedReply, ScriptedStream, SubscribeOptions, SubscribeScript, createBridgeHarness, fault };