@sharpee/channel-service 1.0.0

package/wire/decoder.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * @sharpee/channel-service/wire — client-side decoder
+ *
+ * Owner context: wire-protocol module. A small state machine the
+ * consumer feeds incoming packets through. Enforces the ordering
+ * invariants from ADR-163 §11 / AC-11:
+ *
+ *   1. The first server-bound packet a consumer accepts is `cmgt`.
+ *   2. `turn` packets are accepted only after `cmgt`.
+ *   3. `hello` and `command` are not server-bound — receiving one is a
+ *      protocol error.
+ *
+ * The decoder does NOT render — it only validates ordering and exposes
+ * the negotiated manifest. Renderer dispatch is the consumer's
+ * concern (per ADR-165).
+ *
+ * @see ADR-163 §11 — bootstrap order invariants
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDecoder = createDecoder;
+class DecoderImpl {
+    state = { status: 'awaiting-cmgt' };
+    lastTurn = null;
+    ingest(packet) {
+        if (this.state.status === 'error') {
+            // Stay in error; protocol violations are unrecoverable.
+            return this;
+        }
+        switch (packet.kind) {
+            case 'cmgt': {
+                if (this.state.status !== 'awaiting-cmgt') {
+                    this.state = {
+                        status: 'error',
+                        reason: 'cmgt received after session already live',
+                    };
+                    return this;
+                }
+                this.state = { status: 'live', cmgt: packet };
+                return this;
+            }
+            case 'turn': {
+                if (this.state.status !== 'live') {
+                    this.state = {
+                        status: 'error',
+                        reason: 'turn received before cmgt — bootstrap order requires cmgt first (ADR-163 §11, AC-11d)',
+                    };
+                    this.lastTurn = null;
+                    return this;
+                }
+                this.lastTurn = packet;
+                return this;
+            }
+            case 'hello':
+            case 'command': {
+                // Both are client→server. Receiving one as a server→client
+                // packet is a protocol violation regardless of state.
+                this.state = {
+                    status: 'error',
+                    reason: `unexpected client→server packet '${packet.kind}' on server→client stream`,
+                };
+                this.lastTurn = null;
+                return this;
+            }
+        }
+    }
+}
+/**
+ * Create a fresh client-side decoder in the `awaiting-cmgt` state.
+ */
+function createDecoder() {
+    return new DecoderImpl();
+}
+//# sourceMappingURL=decoder.js.map

package/wire/decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/channel-service/src/wire/decoder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AA2FH,sCAEC;AAvDD,MAAM,WAAW;IACf,KAAK,GAAiB,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAClD,QAAQ,GAAsB,IAAI,CAAC;IAEnC,MAAM,CAAC,MAAkB;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAClC,wDAAwD;YACxD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;oBAC1C,IAAI,CAAC,KAAK,GAAG;wBACX,MAAM,EAAE,OAAO;wBACf,MAAM,EAAE,0CAA0C;qBACnD,CAAC;oBACF,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,IAAI,CAAC,KAAK,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBAC9C,OAAO,IAAI,CAAC;YACd,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBACjC,IAAI,CAAC,KAAK,GAAG;wBACX,MAAM,EAAE,OAAO;wBACf,MAAM,EACJ,uFAAuF;qBAC1F,CAAC;oBACF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;oBACrB,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;gBACvB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,KAAK,OAAO,CAAC;YACb,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,2DAA2D;gBAC3D,sDAAsD;gBACtD,IAAI,CAAC,KAAK,GAAG;oBACX,MAAM,EAAE,OAAO;oBACf,MAAM,EAAE,oCAAoC,MAAM,CAAC,IAAI,2BAA2B;iBACnF,CAAC;gBACF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACrB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,SAAgB,aAAa;IAC3B,OAAO,IAAI,WAAW,EAAE,CAAC;AAC3B,CAAC"}

package/wire/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @sharpee/channel-service/wire
+ *
+ * Wire-protocol module — re-exports the wire-protocol types from
+ * `@sharpee/if-domain`, the canonical home for channel type contracts
+ * (CLAUDE.md rule 7b, ADR-163 §14).
+ *
+ * Why this subpath still exists: a number of consumers historically
+ * imported wire types from `@sharpee/channel-service/wire`. Keeping the
+ * subpath stable means those imports continue to resolve after the
+ * R1 rewrite. New code should import from `@sharpee/if-domain` directly.
+ *
+ * The decoder is the only runtime symbol exported here — its
+ * implementation stays in this package because it carries
+ * bootstrap-order enforcement state.
+ */
+export type { HelloPacket, CmgtPacket, TurnPacket, CommandPacket, WirePacket, ChannelDefinition, ChannelContentType, ChannelMode, ChannelEmitPolicy, ClientCapabilities, } from "../../if-domain/index";
+export { createDecoder, type Decoder, type DecoderState } from './decoder';
+//# sourceMappingURL=index.d.ts.map

package/wire/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/channel-service/src/wire/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,YAAY,EAEV,WAAW,EACX,UAAU,EACV,UAAU,EACV,aAAa,EACb,UAAU,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EAEjB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/wire/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * @sharpee/channel-service/wire
+ *
+ * Wire-protocol module — re-exports the wire-protocol types from
+ * `@sharpee/if-domain`, the canonical home for channel type contracts
+ * (CLAUDE.md rule 7b, ADR-163 §14).
+ *
+ * Why this subpath still exists: a number of consumers historically
+ * imported wire types from `@sharpee/channel-service/wire`. Keeping the
+ * subpath stable means those imports continue to resolve after the
+ * R1 rewrite. New code should import from `@sharpee/if-domain` directly.
+ *
+ * The decoder is the only runtime symbol exported here — its
+ * implementation stays in this package because it carries
+ * bootstrap-order enforcement state.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDecoder = void 0;
+var decoder_1 = require("./decoder");
+Object.defineProperty(exports, "createDecoder", { enumerable: true, get: function () { return decoder_1.createDecoder; } });
+//# sourceMappingURL=index.js.map

package/wire/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/channel-service/src/wire/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAkBH,qCAA2E;AAAlE,wGAAA,aAAa,OAAA"}