@fougere/core 0.9.2-alpha.0 → 0.10.0-alpha.0

package/dist/wire/{CallLog.d.ts → CallRecord.d.ts}

@@ -1,5 +1,5 @@
-import type { RouteKind } from './RouteAddress.js';
-/** What crosses the door. */
+import type { RouteKind } from './RouteKind.js';
+/** What crosses the facade. */
 export interface CallRecord {
     /** Monotonic, and the whole cursor protocol: a reader asks for what is above its own. */
     seq: number;
@@ -22,11 +22,4 @@ export interface CallRecord {
         message: string;
     };
 }
-/** One page of the ring. */
-export interface CallPage {
-    calls: CallRecord[];
-    cursor: number;
-    inFlight: number;
-    dropped: number;
-}
-//# sourceMappingURL=CallLog.d.ts.map
+//# sourceMappingURL=CallRecord.d.ts.map

package/dist/wire/CallRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallRecord.d.ts","sourceRoot":"","sources":["../../src/wire/CallRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,SAAS,GAAG,IAAI,GAAG,QAAQ,CAAC;IACrC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C"}

package/dist/wire/CallRecord.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CallRecord.js.map

package/dist/wire/CallRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallRecord.js","sourceRoot":"","sources":["../../src/wire/CallRecord.ts"],"names":[],"mappings":""}

package/dist/wire/{emit.d.ts → Emit.d.ts}

@@ -5,23 +5,6 @@
  * still refused, by the judge that reads the fact at announce time.
  */
 export type Emit<T, A = never> = (fact: Partial<T>) => Promise<A[]>;
-/**
- * What a subscriber accepts — and what it PROMISES about itself.
- *
- * What it ANSWERS is its own to choose: `Promise<void>` says nothing, any other type is an
- * opinion. It reaches an announcer that asked for one — `Emit<CanBook, Verdict>` — and
- * nobody otherwise, since a plain announcement does not wait.
- */
-export type Fact<T> = T;
-/**
- * The same fact, BEFORE it is final: an op taking one ANSWERS the value every subscriber
- * then receives, so it is the declared form of what `Emissions.stamped` already does for
- * `created()`.
- *
- * Not a second announcement and not a chain a subscriber joins: the links run once, before
- * anyone is handed anything, which is what keeps a fact the same for every reader.
- */
-export type Pipe<T> = T;
 /** The container key of an emission — THE one place that spells the format. */
 export declare function emitKeyOf(fact: string): string;
 /**
@@ -42,4 +25,4 @@ export declare function factsAnnouncedBy(handlers: readonly {
 export declare function factsAwaitedBy(handlers: readonly {
     deps: readonly string[];
 }[]): string[];
-//# sourceMappingURL=emit.d.ts.map
+//# sourceMappingURL=Emit.d.ts.map

package/dist/wire/Emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Emit.d.ts","sourceRoot":"","sources":["../../src/wire/Emit.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;AAEpE,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAMD,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7D;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE9D;AAQD,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS;IAAE,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAAE,GAAG,MAAM,EAAE,CAE3F;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS;IAAE,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAAE,GAAG,MAAM,EAAE,CAEzF"}

package/dist/wire/{emit.js → Emit.js}

@@ -1,8 +1,3 @@
-/**
- * Announcing a fact — the half of the topology `remotes:` never covered.
- *
- * Documented: [facts](https://fougere.dev/docs/business/facts).
- */
 import { lowerFirst } from '@fougere/schema';
 /** The container key of an emission — THE one place that spells the format. */
 export function emitKeyOf(fact) {
@@ -45,4 +40,4 @@ function factsIn(handlers, behindKey) {
             .map(behindKey)
             .filter((fact) => fact !== undefined))];
 }
-//# sourceMappingURL=emit.js.map
+//# sourceMappingURL=Emit.js.map

package/dist/wire/Emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Emit.js","sourceRoot":"","sources":["../../src/wire/Emit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAU7C,+EAA+E;AAC/E,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;AACpC,CAAC;AAED,MAAM,MAAM,GAAG,MAAM,CAAC;AAEtB,MAAM,YAAY,GAAG,OAAO,CAAC;AAE7B,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,MAAM,CAAC,GAAW,EAAE,MAAc;IACzC,OAAO,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QACvD,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QAC9B,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAAC,QAAgD;IAC/E,OAAO,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AAC1C,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,cAAc,CAAC,QAAgD;IAC7E,OAAO,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,OAAO,CACd,QAAgD,EAChD,SAA8C;IAE9C,OAAO,CAAC,GAAG,IAAI,GAAG,CAChB,QAAQ;aACL,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;aAClC,GAAG,CAAC,SAAS,CAAC;aACd,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CACxD,CAAC,CAAC;AACL,CAAC"}

package/dist/wire/ErrorCode.d.ts

@@ -0,0 +1,23 @@
+/** Semantic error codes — transport-agnostic. Each bridge maps them to its own format. */
+export declare enum ErrorCode {
+    VALIDATION_FAILED = "VALIDATION_FAILED",
+    BAD_REQUEST = "BAD_REQUEST",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    FORBIDDEN = "FORBIDDEN",
+    NOT_FOUND = "NOT_FOUND",
+    GONE = "GONE",
+    CONFLICT = "CONFLICT",
+    LOCKED = "LOCKED",
+    METHOD_NOT_ALLOWED = "METHOD_NOT_ALLOWED",
+    PRECONDITION_FAILED = "PRECONDITION_FAILED",
+    PAYLOAD_TOO_LARGE = "PAYLOAD_TOO_LARGE",
+    UNPROCESSABLE_ENTITY = "UNPROCESSABLE_ENTITY",
+    TOO_MANY_REQUESTS = "TOO_MANY_REQUESTS",
+    REQUEST_TIMEOUT = "REQUEST_TIMEOUT",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    NOT_IMPLEMENTED = "NOT_IMPLEMENTED",
+    BAD_GATEWAY = "BAD_GATEWAY",
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    GATEWAY_TIMEOUT = "GATEWAY_TIMEOUT"
+}
+//# sourceMappingURL=ErrorCode.d.ts.map

package/dist/wire/ErrorCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorCode.d.ts","sourceRoot":"","sources":["../../src/wire/ErrorCode.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,oBAAY,SAAS;IAEnB,iBAAiB,sBAAsB;IACvC,WAAW,gBAAgB;IAG3B,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IAGvB,SAAS,cAAc;IACvB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,kBAAkB,uBAAuB;IAGzC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,oBAAoB,yBAAyB;IAC7C,iBAAiB,sBAAsB;IACvC,eAAe,oBAAoB;IAGnC,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAC3B,mBAAmB,wBAAwB;IAC3C,eAAe,oBAAoB;CACpC"}

package/dist/wire/ErrorCode.js

@@ -0,0 +1,30 @@
+/** Semantic error codes — transport-agnostic. Each bridge maps them to its own format. */
+export var ErrorCode;
+(function (ErrorCode) {
+    // Input
+    ErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+    ErrorCode["BAD_REQUEST"] = "BAD_REQUEST";
+    // Auth
+    ErrorCode["UNAUTHORIZED"] = "UNAUTHORIZED";
+    ErrorCode["FORBIDDEN"] = "FORBIDDEN";
+    // Resources
+    ErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    ErrorCode["GONE"] = "GONE";
+    ErrorCode["CONFLICT"] = "CONFLICT";
+    ErrorCode["LOCKED"] = "LOCKED";
+    ErrorCode["METHOD_NOT_ALLOWED"] = "METHOD_NOT_ALLOWED";
+    // Limits
+    ErrorCode["PRECONDITION_FAILED"] = "PRECONDITION_FAILED";
+    ErrorCode["PAYLOAD_TOO_LARGE"] = "PAYLOAD_TOO_LARGE";
+    ErrorCode["UNPROCESSABLE_ENTITY"] = "UNPROCESSABLE_ENTITY";
+    ErrorCode["TOO_MANY_REQUESTS"] = "TOO_MANY_REQUESTS";
+    ErrorCode["REQUEST_TIMEOUT"] = "REQUEST_TIMEOUT";
+    // Server
+    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+    ErrorCode["NOT_IMPLEMENTED"] = "NOT_IMPLEMENTED";
+    ErrorCode["BAD_GATEWAY"] = "BAD_GATEWAY";
+    ErrorCode["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
+    ErrorCode["GATEWAY_TIMEOUT"] = "GATEWAY_TIMEOUT";
+})(ErrorCode || (ErrorCode = {}));
+// ── FougereError ────────────────────────────────
+//# sourceMappingURL=ErrorCode.js.map

package/dist/wire/ErrorCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorCode.js","sourceRoot":"","sources":["../../src/wire/ErrorCode.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,CAAN,IAAY,SA6BX;AA7BD,WAAY,SAAS;IACnB,QAAQ;IACR,oDAAuC,CAAA;IACvC,wCAA2B,CAAA;IAE3B,OAAO;IACP,0CAA6B,CAAA;IAC7B,oCAAuB,CAAA;IAEvB,YAAY;IACZ,oCAAuB,CAAA;IACvB,0BAAa,CAAA;IACb,kCAAqB,CAAA;IACrB,8BAAiB,CAAA;IACjB,sDAAyC,CAAA;IAEzC,SAAS;IACT,wDAA2C,CAAA;IAC3C,oDAAuC,CAAA;IACvC,0DAA6C,CAAA;IAC7C,oDAAuC,CAAA;IACvC,gDAAmC,CAAA;IAEnC,SAAS;IACT,8CAAiC,CAAA;IACjC,gDAAmC,CAAA;IACnC,wCAA2B,CAAA;IAC3B,wDAA2C,CAAA;IAC3C,gDAAmC,CAAA;AACrC,CAAC,EA7BW,SAAS,KAAT,SAAS,QA6BpB;AAED,mDAAmD"}

package/dist/wire/Facade.d.ts

@@ -0,0 +1,10 @@
+import type { InvocationContext } from './InvocationContext.js';
+/** The facade built in front of a handler — the framework's second port, after `Storage`. */
+export type Facade<T> = {
+    [K in keyof T]: T[K] extends (...args: never[]) => infer R ? (invocation?: InvocationContext) => R : never;
+};
+/** The container key of a façade — THE one place that spells the format. */
+export declare function facadeKeyOf(entityName: string, surface?: string): string;
+/** Where the contracts behind a façade live — the dual of `facadeKeyOf`. */
+export declare function contractsKeyOf(entityName: string, surface?: string): string;
+//# sourceMappingURL=Facade.d.ts.map

package/dist/wire/Facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Facade.d.ts","sourceRoot":"","sources":["../../src/wire/Facade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAYhE,6FAA6F;AAC7F,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;KACrB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,MAAM,CAAC,GACtD,CAAC,UAAU,CAAC,EAAE,iBAAiB,KAAK,CAAC,GACrC,KAAK;CACV,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/wire/Facade.js

@@ -0,0 +1,9 @@
+/** The container key of a façade — THE one place that spells the format. */
+export function facadeKeyOf(entityName, surface) {
+    return surface ? `${surface}:${entityName}Handler` : `${entityName}Handler`;
+}
+/** Where the contracts behind a façade live — the dual of `facadeKeyOf`. */
+export function contractsKeyOf(entityName, surface) {
+    return `${facadeKeyOf(entityName, surface)}:contracts`;
+}
+//# sourceMappingURL=Facade.js.map

package/dist/wire/Facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Facade.js","sourceRoot":"","sources":["../../src/wire/Facade.ts"],"names":[],"mappings":"AAmBA,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,OAAgB;IAC9D,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,UAAU,SAAS,CAAC,CAAC,CAAC,GAAG,UAAU,SAAS,CAAC;AAC9E,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,OAAgB;IACjE,OAAO,GAAG,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC;AACzD,CAAC"}

package/dist/wire/FacadeName.d.ts

@@ -0,0 +1,14 @@
+/**
+ * One facade: where a call goes, and the handler that answers there.
+ *
+ * The address is carried as a LITERAL, which is what lets an operation be looked up by
+ * `address.op`. A page never builds one by hand — the scan writes a `const` per address, and a
+ * page imports it, so a project that never generated them fails to resolve rather than losing
+ * its types in silence.
+ */
+export interface FacadeName<Handler, Address extends string> {
+    readonly address: Address;
+    /** Never read: it is how the handler's own signatures reach the page. */
+    readonly handler?: Handler;
+}
+//# sourceMappingURL=FacadeName.d.ts.map

package/dist/wire/FacadeName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FacadeName.d.ts","sourceRoot":"","sources":["../../src/wire/FacadeName.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU,CAAC,OAAO,EAAE,OAAO,SAAS,MAAM;IACzD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B"}

package/dist/wire/FacadeName.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=FacadeName.js.map

package/dist/wire/FacadeName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FacadeName.js","sourceRoot":"","sources":["../../src/wire/FacadeName.ts"],"names":[],"mappings":""}

package/dist/wire/Fact.d.ts

@@ -0,0 +1,9 @@
+/**
+ * What a subscriber accepts — and what it PROMISES about itself.
+ *
+ * What it ANSWERS is its own to choose: `Promise<void>` says nothing, any other type is an
+ * opinion. It reaches an announcer that asked for one — `Emit<CanBook, Verdict>` — and
+ * nobody otherwise, since a plain announcement does not wait.
+ */
+export type Fact<T> = T;
+//# sourceMappingURL=Fact.d.ts.map

package/dist/wire/Fact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fact.d.ts","sourceRoot":"","sources":["../../src/wire/Fact.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC"}

package/dist/wire/Fact.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Fact.js.map

package/dist/wire/Fact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fact.js","sourceRoot":"","sources":["../../src/wire/Fact.ts"],"names":[],"mappings":""}

package/dist/wire/FougereError.d.ts

@@ -0,0 +1,35 @@
+import type { ValidationError } from '@fougere/schema';
+import { ErrorCode } from './ErrorCode.js';
+import type { FougereErrorOptions } from './FougereErrorOptions.js';
+/**
+ * A refusal, and which one — narrowed by the operation that answered it where the caller knows.
+ *
+ * `Code` defaults to every code there is, so a thrower writes what it always wrote. What it buys
+ * is on the READING side: a client generated from a card gets `FougereError<'NOT_FOUND' |
+ * 'CONFLICT'>`, and a `switch` over `code` with a `never` in its default stops compiling the day
+ * the op learns to refuse something else.
+ *
+ * Documented: [observability](https://fougere.dev/docs/infra/observability).
+ */
+export declare class FougereError<Code extends ErrorCode = ErrorCode> extends Error {
+    readonly code: Code;
+    readonly entity?: string;
+    readonly operation?: string;
+    readonly details?: unknown;
+    constructor(options: FougereErrorOptions<Code>);
+    toJSON(): {
+        details?: {} | null | undefined;
+        operation?: string | undefined;
+        entity?: string | undefined;
+        code: Code;
+        message: string;
+    };
+    /** Dual of toJSON — rebuild a typed error from its wire form. */
+    static fromJSON(json: unknown): FougereError;
+}
+/**
+ * The refusals behind a VALIDATION_FAILED, or nothing — the ONE place that reads `details` under
+ * that code.
+ */
+export declare function validationErrorsOf(error: unknown): ValidationError[] | undefined;
+//# sourceMappingURL=FougereError.d.ts.map

package/dist/wire/FougereError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FougereError.d.ts","sourceRoot":"","sources":["../../src/wire/FougereError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;;;;;;;;GASG;AACH,qBAAa,YAAY,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,KAAK;IACzE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,OAAO,EAAE,mBAAmB,CAAC,IAAI,CAAC;IAS9C,MAAM;;;;;;;IAUN,iEAAiE;IACjE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY;CAW7C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,GAAG,SAAS,CAWhF"}

package/dist/wire/{errors.js → FougereError.js}

@@ -1,37 +1,14 @@
+import { ErrorCode } from './ErrorCode.js';
 /**
- * The error vocabulary — what a refusal IS, independently of who hears it.
+ * A refusal, and which one — narrowed by the operation that answered it where the caller knows.
  *
- * Documented: [errors](https://fougere.dev/docs/business/errors).
+ * `Code` defaults to every code there is, so a thrower writes what it always wrote. What it buys
+ * is on the READING side: a client generated from a card gets `FougereError<'NOT_FOUND' |
+ * 'CONFLICT'>`, and a `switch` over `code` with a `never` in its default stops compiling the day
+ * the op learns to refuse something else.
+ *
+ * Documented: [observability](https://fougere.dev/docs/infra/observability).
  */
-// ── ErrorCode ──────────────────────────────────
-/** Semantic error codes — transport-agnostic. Each bridge maps them to its own format. */
-export var ErrorCode;
-(function (ErrorCode) {
-    // Input
-    ErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
-    ErrorCode["BAD_REQUEST"] = "BAD_REQUEST";
-    // Auth
-    ErrorCode["UNAUTHORIZED"] = "UNAUTHORIZED";
-    ErrorCode["FORBIDDEN"] = "FORBIDDEN";
-    // Resources
-    ErrorCode["NOT_FOUND"] = "NOT_FOUND";
-    ErrorCode["GONE"] = "GONE";
-    ErrorCode["CONFLICT"] = "CONFLICT";
-    ErrorCode["LOCKED"] = "LOCKED";
-    ErrorCode["METHOD_NOT_ALLOWED"] = "METHOD_NOT_ALLOWED";
-    // Limits
-    ErrorCode["PRECONDITION_FAILED"] = "PRECONDITION_FAILED";
-    ErrorCode["PAYLOAD_TOO_LARGE"] = "PAYLOAD_TOO_LARGE";
-    ErrorCode["UNPROCESSABLE_ENTITY"] = "UNPROCESSABLE_ENTITY";
-    ErrorCode["TOO_MANY_REQUESTS"] = "TOO_MANY_REQUESTS";
-    ErrorCode["REQUEST_TIMEOUT"] = "REQUEST_TIMEOUT";
-    // Server
-    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
-    ErrorCode["NOT_IMPLEMENTED"] = "NOT_IMPLEMENTED";
-    ErrorCode["BAD_GATEWAY"] = "BAD_GATEWAY";
-    ErrorCode["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
-    ErrorCode["GATEWAY_TIMEOUT"] = "GATEWAY_TIMEOUT";
-})(ErrorCode || (ErrorCode = {}));
 export class FougereError extends Error {
     code;
     entity;
@@ -82,4 +59,4 @@ export function validationErrorsOf(error) {
         && typeof entry.message === 'string');
     return refusals.length === details.length ? refusals : undefined;
 }
-//# sourceMappingURL=errors.js.map
+//# sourceMappingURL=FougereError.js.map

package/dist/wire/FougereError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FougereError.js","sourceRoot":"","sources":["../../src/wire/FougereError.ts"],"names":[],"mappings":"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"}

package/dist/wire/FougereErrorOptions.d.ts

@@ -0,0 +1,10 @@
+import type { ErrorCode } from './ErrorCode.js';
+export interface FougereErrorOptions<Code extends ErrorCode = ErrorCode> {
+    code: Code;
+    message: string;
+    entity?: string;
+    operation?: string;
+    details?: unknown;
+    cause?: unknown;
+}
+//# sourceMappingURL=FougereErrorOptions.d.ts.map

package/dist/wire/FougereErrorOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FougereErrorOptions.d.ts","sourceRoot":"","sources":["../../src/wire/FougereErrorOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,mBAAmB,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS;IACrE,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/wire/FougereErrorOptions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=FougereErrorOptions.js.map

package/dist/wire/FougereErrorOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FougereErrorOptions.js","sourceRoot":"","sources":["../../src/wire/FougereErrorOptions.ts"],"names":[],"mappings":""}

package/dist/wire/FougereHandlers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The handler behind each address, carried as `import('…/PostHandler').default`.
+ *
+ * TypeScript resolves it from the source, so the operations that exist and what each one
+ * answers cost the generated module nothing: no signature is printed into it, and none can
+ * drift from the class it was read off.
+ */
+export interface FougereHandlers {
+}
+//# sourceMappingURL=FougereHandlers.d.ts.map

package/dist/wire/FougereHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FougereHandlers.d.ts","sourceRoot":"","sources":["../../src/wire/FougereHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;CAAG"}

package/dist/wire/FougereHandlers.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=FougereHandlers.js.map

package/dist/wire/FougereHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FougereHandlers.js","sourceRoot":"","sources":["../../src/wire/FougereHandlers.ts"],"names":[],"mappings":""}

package/dist/wire/FougereOperations.d.ts

@@ -0,0 +1,4 @@
+/** What one facade answers for, keyed `address.op` — `surface:address.op` for a named surface. */
+export interface FougereOperations {
+}
+//# sourceMappingURL=FougereOperations.d.ts.map

package/dist/wire/FougereOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FougereOperations.d.ts","sourceRoot":"","sources":["../../src/wire/FougereOperations.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,MAAM,WAAW,iBAAiB;CAAG"}

package/dist/wire/FougereOperations.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=FougereOperations.js.map

package/dist/wire/FougereOperations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FougereOperations.js","sourceRoot":"","sources":["../../src/wire/FougereOperations.ts"],"names":[],"mappings":""}

package/dist/wire/FrondCall.d.ts

@@ -0,0 +1,10 @@
+/** Target of a call — which façade operation, wherever it lives. */
+export interface FrondCall {
+    /** Frond name, when the caller knows it. Routing hint only. */
+    frond?: string;
+    /** Entity registration key (e.g. 'product'). */
+    entity: string;
+    /** Façade operation name (e.g. 'findById', 'search'). */
+    op: string;
+}
+//# sourceMappingURL=FrondCall.d.ts.map

package/dist/wire/FrondCall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrondCall.d.ts","sourceRoot":"","sources":["../../src/wire/FrondCall.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,WAAW,SAAS;IACxB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/dist/wire/FrondCall.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=FrondCall.js.map

package/dist/wire/FrondCall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrondCall.js","sourceRoot":"","sources":["../../src/wire/FrondCall.ts"],"names":[],"mappings":""}

package/dist/wire/HandlerOf.d.ts

@@ -0,0 +1,10 @@
+import type { FougereHandlers } from './FougereHandlers.js';
+import type { AnyHandler } from './AnyHandler.js';
+/**
+ * The handler that answers at one address. It falls back to an unconstrained facade when nothing
+ * was generated, because a `never` there would refuse every call a project makes.
+ */
+export type HandlerOf<Address extends string> = [
+    keyof FougereHandlers
+] extends [never] ? AnyHandler : Address extends keyof FougereHandlers ? FougereHandlers[Address] : AnyHandler;
+//# sourceMappingURL=HandlerOf.d.ts.map

package/dist/wire/HandlerOf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandlerOf.d.ts","sourceRoot":"","sources":["../../src/wire/HandlerOf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,OAAO,SAAS,MAAM,IAC1C;IAAC,MAAM,eAAe;CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,UAAU,GAClD,OAAO,SAAS,MAAM,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC"}

package/dist/wire/HandlerOf.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=HandlerOf.js.map

package/dist/wire/HandlerOf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HandlerOf.js","sourceRoot":"","sources":["../../src/wire/HandlerOf.ts"],"names":[],"mappings":""}

package/dist/wire/Invocation.d.ts

@@ -1,13 +1,5 @@
-export interface InvocationContext {
-    params: Record<string, unknown>;
-    query: Record<string, unknown>;
-    input: unknown;
-    state: Record<string, unknown>;
-    trace?: string;
-    identity?: string;
-    caller?: string;
-}
-export type PartialInvocation = Partial<InvocationContext>;
+import type { InvocationContext } from './InvocationContext.js';
+import type { PartialInvocation } from './PartialInvocation.js';
 /** Canonical invocation shared by every entry and transport. */
 export declare class Invocation implements InvocationContext {
     readonly params: Record<string, unknown>;

package/dist/wire/Invocation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Invocation.d.ts","sourceRoot":"","sources":["../../src/wire/Invocation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAuB3D,gEAAgE;AAChE,qBAAa,UAAW,YAAW,iBAAiB;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,iFAAiF;IACjF,OAAO;IAaP,yFAAyF;IACzF,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU;IAIpD,MAAM,CAAC,QAAQ,CAAC,KAAK,aAAqB;IAE1C,wEAAwE;IACxE,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU;IAIrC,0FAA0F;IAC1F,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU;CAGtD"}
+{"version":3,"file":"Invocation.d.ts","sourceRoot":"","sources":["../../src/wire/Invocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAuBhE,gEAAgE;AAChE,qBAAa,UAAW,YAAW,iBAAiB;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,iFAAiF;IACjF,OAAO;IAaP,yFAAyF;IACzF,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU;IAIpD,MAAM,CAAC,QAAQ,CAAC,KAAK,aAAqB;IAE1C,wEAAwE;IACxE,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU;IAIrC,0FAA0F;IAC1F,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU;CAGtD"}

package/dist/wire/Invocation.js.map

@@ -1 +1 @@
-{"version":3,"file":"Invocation.js","sourceRoot":"","sources":["../../src/wire/Invocation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Invocation.js","sourceRoot":"","sources":["../../src/wire/Invocation.ts"],"names":[],"mappings":"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"}

package/dist/wire/InvocationContext.d.ts

@@ -0,0 +1,10 @@
+export interface InvocationContext {
+    params: Record<string, unknown>;
+    query: Record<string, unknown>;
+    input: unknown;
+    state: Record<string, unknown>;
+    trace?: string;
+    identity?: string;
+    caller?: string;
+}
+//# sourceMappingURL=InvocationContext.d.ts.map

package/dist/wire/InvocationContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvocationContext.d.ts","sourceRoot":"","sources":["../../src/wire/InvocationContext.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/wire/InvocationContext.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=InvocationContext.js.map

package/dist/wire/InvocationContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvocationContext.js","sourceRoot":"","sources":["../../src/wire/InvocationContext.ts"],"names":[],"mappings":""}

package/dist/wire/{middleware.d.ts → OperationContext.d.ts}

@@ -1,4 +1,3 @@
-/** App-level middleware — intercepts handler facade operations. */
 export interface OperationContext {
     /** Entity name (e.g. 'product'). */
     entity: string;
@@ -14,12 +13,6 @@ export interface OperationContext {
     /** Extensible bag — middlewares deposit data here (user, permissions, etc.). */
     state: Record<string, unknown>;
     /** Transport-agnostic invocation context (params, query, input, state). */
-    invocation?: import('../wire/Invocation.js').InvocationContext;
+    invocation?: import('./InvocationContext.js').InvocationContext;
 }
-export type AppNext = () => Promise<unknown>;
-export type AppMiddleware = (ctx: OperationContext, next: AppNext) => Promise<unknown>;
-/**
- * Execute a middleware chain (onion model) then the handler.
- */
-export declare function runMiddlewares(middlewares: AppMiddleware[], ctx: OperationContext, handler: AppNext): Promise<unknown>;
-//# sourceMappingURL=middleware.d.ts.map
+//# sourceMappingURL=OperationContext.d.ts.map

package/dist/wire/OperationContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationContext.d.ts","sourceRoot":"","sources":["../../src/wire/OperationContext.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,wBAAwB,EAAE,iBAAiB,CAAC;CACjE"}

package/dist/wire/OperationContext.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=OperationContext.js.map

package/dist/wire/OperationContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationContext.js","sourceRoot":"","sources":["../../src/wire/OperationContext.ts"],"names":[],"mappings":""}

package/dist/wire/{operation.d.ts → OperationContract.d.ts}

@@ -1,6 +1,10 @@
 import type { SchemaView } from '@fougere/schema';
 import type { BindingPlan } from './binding.js';
-import type { Signature, TypeRef, Param } from './signature.js';
+import type { Signature } from './Signature.js';
+import type { TypeRef } from './TypeRef.js';
+import type { ErrorCode } from './ErrorCode.js';
+import type { OperationKind } from './OperationKind.js';
+import type { OperationKindInference } from './OperationKindInference.js';
 /** The contract of one operation — everything the façade needs to serve a call. */
 export interface OperationContract {
     /** Judged on the way in. The view carries its own mode (`partial()` → patch). */
@@ -15,19 +19,18 @@ export interface OperationContract {
     cardinality?: 'one' | 'maybe' | 'many' | 'page' | 'none';
     /** The argument names and TYPES — the one thing `binding` cannot say. */
     signature?: Signature;
+    /**
+     * The refusals a path from this operation can reach, walked from every `throw` upward.
+     *
+     * What the FRAMEWORK refuses is not here: `VALIDATION_FAILED` follows from `input`,
+     * `SERVICE_UNAVAILABLE` from being dispatched at all, the gateway pair from a remote
+     * placement — all already on the card, so listing them per op would write one fact twice.
+     * `refusalsOf` puts the two halves together for whoever reads.
+     */
+    errors?: ErrorCode[];
 }
 /** Read an op's cardinality off its parsed return type. */
 export declare function cardinalityOf(type: TypeRef | undefined): OperationContract['cardinality'];
-/** Map of operation name → its contract. */
-export type OperationsMap = Map<string, OperationContract>;
-export type { TypeRef, Param };
-export type OperationKind = 'query' | 'command';
-/** The convention's evidence, including both sides when a composed name contradicts itself. */
-export interface OperationKindInference {
-    kind?: OperationKind;
-    queryMatches: string[];
-    commandMatches: string[];
-}
 /** The two lists, for a refusal that has to say what a name could have led with. */
 export declare function knownVerbs(): {
     query: string[];
@@ -51,4 +54,4 @@ export declare function isReadOp(name: string): boolean;
 export declare function resolveIsReadOp(name: string, overrides?: Record<string, {
     kind?: OperationKind;
 }>): boolean;
-//# sourceMappingURL=operation.d.ts.map
+//# sourceMappingURL=OperationContract.d.ts.map

package/dist/wire/OperationContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationContract.d.ts","sourceRoot":"","sources":["../../src/wire/OperationContract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,gCAAgC;IAChC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,WAAW,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACzD,yEAAyE;IACzE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAQzF;AA0BD,oFAAoF;AACpF,wBAAgB,UAAU,IAAI;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAEnE;AAYD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CA4BvE;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,GACnD,aAAa,GAAG,SAAS,CAE3B;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,GACnD,OAAO,CAET"}

package/dist/wire/{operation.js → OperationContract.js}

@@ -102,4 +102,4 @@ function requireOperationKind(name, overrides) {
     throw new Error(`Cannot infer operation kind from '${name}'. `
         + `Declare operations.${name}.kind as 'query' or 'command' in frond.config.ts.`);
 }
-//# sourceMappingURL=operation.js.map
+//# sourceMappingURL=OperationContract.js.map