@av-pi-studio/protocol 0.0.1

package/dist/endpoint.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Daemon endpoint / host parsing (MAIN-SCOPE §4 protocol responsibilities).
+ *
+ * Parses a daemon target into a normalized descriptor. Supported forms:
+ *  - `host:port` / `host`                      → direct (default port 6767)
+ *  - `tcp://host:port?ssl=&password=`          → direct, with ssl/password params
+ *  - `ws://host:port` / `wss://host:port`      → direct (wss ⇒ ssl)
+ *  - `relay://relayHost[:port]/<relayId>?...`  → relay
+ */
+/** Default daemon listen port (MAIN-SCOPE §2: `127.0.0.1:6767`). */
+export declare const DEFAULT_DAEMON_PORT = 6767;
+export interface EndpointDescriptor {
+    kind: "direct" | "relay";
+    host: string;
+    port: number;
+    ssl: boolean;
+    password?: string;
+    /** Relay channel/server id (relay endpoints only). */
+    relayId?: string;
+    /** The original input string. */
+    raw: string;
+}
+/** Parse a daemon target string into a normalized {@link EndpointDescriptor}. */
+export declare function parseEndpoint(input: string, opts?: {
+    defaultPort?: number;
+}): EndpointDescriptor;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAsBD,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,CA4ChG"}

package/dist/endpoint.js

@@ -0,0 +1,75 @@
+/**
+ * Daemon endpoint / host parsing (MAIN-SCOPE §4 protocol responsibilities).
+ *
+ * Parses a daemon target into a normalized descriptor. Supported forms:
+ *  - `host:port` / `host`                      → direct (default port 6767)
+ *  - `tcp://host:port?ssl=&password=`          → direct, with ssl/password params
+ *  - `ws://host:port` / `wss://host:port`      → direct (wss ⇒ ssl)
+ *  - `relay://relayHost[:port]/<relayId>?...`  → relay
+ */
+/** Default daemon listen port (MAIN-SCOPE §2: `127.0.0.1:6767`). */
+export const DEFAULT_DAEMON_PORT = 6767;
+function truthyFlag(value) {
+    if (value === null)
+        return false;
+    const v = value.trim().toLowerCase();
+    return v === "" ? true : v === "1" || v === "true" || v === "yes" || v === "on";
+}
+function splitHostPort(authority, defaultPort) {
+    // IPv6 literal in brackets: [::1]:6767
+    const bracket = authority.match(/^\[(.+)\](?::(\d+))?$/);
+    if (bracket) {
+        return { host: bracket[1], port: bracket[2] ? Number(bracket[2]) : defaultPort };
+    }
+    const idx = authority.lastIndexOf(":");
+    if (idx === -1)
+        return { host: authority, port: defaultPort };
+    const host = authority.slice(0, idx);
+    const portStr = authority.slice(idx + 1);
+    const port = Number(portStr);
+    return { host, port: Number.isFinite(port) && portStr !== "" ? port : defaultPort };
+}
+/** Parse a daemon target string into a normalized {@link EndpointDescriptor}. */
+export function parseEndpoint(input, opts) {
+    const raw = input.trim();
+    if (raw === "")
+        throw new Error("empty endpoint");
+    const defaultPort = opts?.defaultPort ?? DEFAULT_DAEMON_PORT;
+    const schemeMatch = raw.match(/^([a-z][a-z0-9+.-]*):\/\//i);
+    if (!schemeMatch) {
+        // Bare `host` or `host:port`.
+        const { host, port } = splitHostPort(raw, defaultPort);
+        return { kind: "direct", host, port, ssl: false, raw };
+    }
+    const scheme = schemeMatch[1].toLowerCase();
+    const url = new URL(raw);
+    const params = url.searchParams;
+    const password = params.get("password") ?? undefined;
+    if (scheme === "relay") {
+        const port = url.port ? Number(url.port) : defaultPort;
+        const relayId = url.pathname.replace(/^\/+/, "") || params.get("relayId") || undefined;
+        const ssl = truthyFlag(params.get("ssl")) || truthyFlag(params.get("tls"));
+        return {
+            kind: "relay",
+            host: url.hostname,
+            port,
+            ssl,
+            ...(password !== undefined ? { password } : {}),
+            ...(relayId ? { relayId } : {}),
+            raw,
+        };
+    }
+    // direct schemes: tcp, ws, wss, http, https
+    const sslFromScheme = scheme === "wss" || scheme === "https";
+    const ssl = sslFromScheme || truthyFlag(params.get("ssl")) || truthyFlag(params.get("tls"));
+    const port = url.port ? Number(url.port) : defaultPort;
+    return {
+        kind: "direct",
+        host: url.hostname,
+        port,
+        ssl,
+        ...(password !== undefined ? { password } : {}),
+        raw,
+    };
+}
+//# sourceMappingURL=endpoint.js.map

package/dist/endpoint.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/** Protocol package version marker; real wire schemas land in sprint-002. */
+export declare const PROTOCOL_PACKAGE: "@av-pi-studio/protocol";
+export * from "./validation.js";
+export * from "./messages.js";
+export * from "./client-capabilities.js";
+export * from "./binary-frames/index.js";
+export * from "./endpoint.js";
+export * from "./provider-manifest.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,EAAG,wBAAiC,CAAC;AAGlE,cAAc,iBAAiB,CAAC;AAGhC,cAAc,eAAe,CAAC;AAG9B,cAAc,0BAA0B,CAAC;AAGzC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,eAAe,CAAC;AAG9B,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+// @av-pi-studio/protocol — shared wire schemas, codecs, capability flags.
+// Depends on no other workspace package (see MAIN-SCOPE.md §3).
+/** Protocol package version marker; real wire schemas land in sprint-002. */
+export const PROTOCOL_PACKAGE = "@av-pi-studio/protocol";
+// Shared validation conventions + base primitive schemas (reused by protocol + persistence).
+export * from "./validation.js";
+// WebSocket wire schemas: top-level envelopes, handshake, session messages.
+export * from "./messages.js";
+// Capability flags + serialization-time gating.
+export * from "./client-capabilities.js";
+// Binary frame codecs (terminal stream + file transfer).
+export * from "./binary-frames/index.js";
+// Endpoint/host parsing.
+export * from "./endpoint.js";
+// Provider manifest types.
+export * from "./provider-manifest.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,gEAAgE;AAEhE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAiC,CAAC;AAElE,6FAA6F;AAC7F,cAAc,iBAAiB,CAAC;AAEhC,4EAA4E;AAC5E,cAAc,eAAe,CAAC;AAE9B,gDAAgD;AAChD,cAAc,0BAA0B,CAAC;AAEzC,yDAAyD;AACzD,cAAc,0BAA0B,CAAC;AAEzC,yBAAyB;AACzB,cAAc,eAAe,CAAC;AAE9B,2BAA2B;AAC3B,cAAc,wBAAwB,CAAC"}