@ganglion/xacpx-relay 0.1.0

package/dist/db.d.ts

@@ -0,0 +1,9 @@
+export interface SqlDriver {
+    exec(sql: string): void;
+    run(sql: string, params?: ReadonlyArray<string | number | null>): void;
+    get<T>(sql: string, params?: ReadonlyArray<string | number | null>): T | undefined;
+    all<T>(sql: string, params?: ReadonlyArray<string | number | null>): T[];
+    close(): void;
+}
+export declare function createSqlDriver(path: string): Promise<SqlDriver>;
+export declare function initSchema(db: SqlDriver): void;

package/dist/gateway/instance-gateway.d.ts

@@ -0,0 +1,30 @@
+import { type RelayEnvelope } from "@ganglion/xacpx-relay-protocol";
+import type { AccountStore } from "../stores/accounts.js";
+import type { InstanceStore } from "../stores/instances.js";
+/** Single authoritative default for the gateway RPC timeout, shared by the server layer. */
+export declare const DEFAULT_REQUEST_TIMEOUT_MS = 120000;
+export interface GatewaySocket {
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    on(event: "message", listener: (data: unknown) => void): unknown;
+    on(event: "close", listener: () => void): unknown;
+}
+export interface InstanceGatewayDeps {
+    instances: Pick<InstanceStore, "redeemPairingToken" | "registerInstanceForAccount" | "verifyCredential" | "touch">;
+    accounts: Pick<AccountStore, "resolveLoginToken">;
+    requestTimeoutMs?: number;
+    onEvent?: (instanceId: string, accountId: string, envelope: RelayEnvelope) => void;
+    onStatusChange?: (instanceId: string, accountId: string, online: boolean) => void;
+}
+export declare class InstanceGateway {
+    private readonly deps;
+    private readonly connections;
+    private readonly pending;
+    private seq;
+    constructor(deps: InstanceGatewayDeps);
+    isOnline(instanceId: string): boolean;
+    handleConnection(socket: GatewaySocket): void;
+    /** Returns the authed identity, or null (after replying/closing) when the handshake fails. */
+    private handleHandshake;
+    sendRequest(instanceId: string, type: string, payload: unknown): Promise<unknown>;
+}

package/dist/gateway/web-gateway.d.ts

@@ -0,0 +1,11 @@
+import { type WebServerEvent } from "@ganglion/xacpx-relay-protocol";
+export interface WebSocketLike {
+    send(data: string): void;
+    on(event: "close", listener: () => void): unknown;
+}
+/** Tracks authenticated browser sockets per account and fans events out to them. */
+export declare class WebGateway {
+    private readonly byAccount;
+    register(accountId: string, socket: WebSocketLike): void;
+    broadcast(accountId: string, event: WebServerEvent): void;
+}

package/dist/http/app.d.ts

@@ -0,0 +1,33 @@
+import { Hono } from "hono";
+import { type LiveTurnSnapshotDto } from "@ganglion/xacpx-relay-protocol";
+import type { AccountRow, AccountStore } from "../stores/accounts.js";
+import type { InstanceStore } from "../stores/instances.js";
+import type { MessageStore } from "../stores/messages.js";
+export interface GatewayForApp {
+    isOnline(instanceId: string): boolean;
+    sendRequest(instanceId: string, type: string, payload: unknown): Promise<unknown>;
+}
+export interface AppDeps {
+    accounts: AccountStore;
+    instances: InstanceStore;
+    gateway: GatewayForApp;
+    messages: MessageStore;
+    /** Snapshot the in-flight turns for an instance (for the active-turns endpoint). */
+    activeTurns?: (instanceId: string) => LiveTurnSnapshotDto[];
+    webRoot?: string;
+    sessionTtlMs?: number;
+    pairingTtlMs?: number;
+    historyRetentionDays?: number;
+    maxMessagesPerSession?: number;
+    trustProxy?: boolean;
+    now?: () => Date;
+}
+export declare const LOGIN_MAX_FAILURES = 10;
+export declare const GLOBAL_MAX_FAILURES = 200;
+type Vars = {
+    Variables: {
+        account: AccountRow;
+    };
+};
+export declare function createApp(deps: AppDeps): Hono<Vars>;
+export {};

package/dist/http/client-ip.d.ts

@@ -0,0 +1,2 @@
+import type { Context } from "hono";
+export declare function clientIp(c: Context, trustProxy: boolean): string;

package/dist/maintenance.d.ts

@@ -0,0 +1,22 @@
+import type { AccountStore } from "./stores/accounts.js";
+import type { InstanceStore } from "./stores/instances.js";
+import type { MessageStore } from "./stores/messages.js";
+export interface MaintenanceStores {
+    accounts: AccountStore;
+    instances: InstanceStore;
+    messages: MessageStore;
+}
+export interface MaintenanceOptions {
+    historyRetentionDays: number;
+    maxPerSession: number;
+    now?: () => Date;
+}
+export interface MaintenanceSummary {
+    messagesDeleted: number;
+    sessionsDeleted: number;
+    pairingTokensDeleted: number;
+}
+/** Runs one maintenance pass: prune old/excess messages, GC expired sessions/pairing tokens. */
+export declare function runMaintenance(stores: MaintenanceStores, opts: MaintenanceOptions): MaintenanceSummary;
+/** Starts a periodic maintenance loop. Returns a stop function. */
+export declare function startMaintenanceLoop(stores: MaintenanceStores, opts: MaintenanceOptions, intervalMs: number, onError?: (err: unknown) => void): () => void;

package/dist/relay-web/assets/BrandLogo.vue_vue_type_script_setup_true_lang-CSPZDDtK.js

@@ -0,0 +1 @@
+import{d as e,o as s,c as a,O as n}from"./index-DE2bTqBl.js";const o={class:"flex items-center gap-2 select-none"},d=e({__name:"BrandLogo",setup(r){return(p,t)=>(s(),a("div",o,[...t[0]||(t[0]=[n('<svg data-test="brand-x" width="22" height="22" viewBox="0 0 24 24" fill="none" aria-hidden="true"><defs><linearGradient id="xacpxBrand" x1="3" y1="3" x2="21" y2="21" gradientUnits="userSpaceOnUse"><stop stop-color="#4F9BF5"></stop><stop offset="1" stop-color="#69D689"></stop></linearGradient></defs><path d="M5 5 L19 19 M19 5 L5 19" stroke="url(#xacpxBrand)" stroke-width="3.2" stroke-linecap="round"></path></svg><span class="text-[15px] font-semibold tracking-tight text-fg">xacpx</span><span class="text-fg-muted text-xs">· relay</span>',3)])]))}});export{d as _};

package/dist/relay-web/assets/DashboardView-AMivJ-D8.css

@@ -0,0 +1 @@
+.stream-md>:first-child{margin-top:0}.stream-md>:last-child{margin-bottom:0}.stream-md p{margin:.5em 0;line-height:1.5}.stream-md h1,.stream-md h2,.stream-md h3,.stream-md h4{margin:.8em 0 .4em;font-weight:600;line-height:1.3}.stream-md h1{font-size:1.3em}.stream-md h2{font-size:1.2em}.stream-md h3{font-size:1.1em}.stream-md ul,.stream-md ol{margin:.5em 0;padding-left:1.4em}.stream-md ul{list-style:disc}.stream-md ol{list-style:decimal}.stream-md li{margin:.2em 0}.stream-md a{color:rgb(var(--c-accent));text-decoration:underline}.stream-md code{background:rgb(var(--c-surface));color:rgb(var(--c-fg));border-radius:4px;padding:.1em .3em;font-family:JetBrains Mono,ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12.5px}.stream-md pre{background:rgb(var(--c-bg));color:rgb(var(--c-fg));border:1px solid rgb(var(--c-border));border-radius:8px;padding:.65em .85em;overflow-x:auto;margin:.6em 0;box-shadow:var(--shadow-e1)}.stream-md pre::-webkit-scrollbar{height:8px}.stream-md pre::-webkit-scrollbar-thumb{background:rgb(var(--c-fg-muted) / .28);border-radius:8px}.stream-md pre::-webkit-scrollbar-track{background:transparent}.stream-md pre code{background:transparent;padding:0;color:inherit;font-size:13px;line-height:1.6}.stream-md .hljs-keyword,.stream-md .hljs-built_in,.stream-md .hljs-name,.stream-md .hljs-tag{color:rgb(var(--c-accent))}.stream-md .hljs-string,.stream-md .hljs-attr,.stream-md .hljs-symbol{color:rgb(var(--c-run))}.stream-md .hljs-comment,.stream-md .hljs-quote{color:rgb(var(--c-fg-muted))}.stream-md .hljs-number,.stream-md .hljs-literal{color:rgb(var(--c-info))}.stream-md blockquote{border-left:3px solid rgb(var(--c-border));margin:.6em 0;padding-left:.8em;color:rgb(var(--c-fg-muted))}.stream-md .md-table-wrap{max-width:100%;overflow-x:auto;margin:.6em 0}.stream-md .md-table-wrap::-webkit-scrollbar{height:8px}.stream-md .md-table-wrap::-webkit-scrollbar-thumb{background:rgb(var(--c-fg-muted) / .28);border-radius:8px}.stream-md .md-table-wrap::-webkit-scrollbar-track{background:transparent}.stream-md table{border-collapse:collapse}.stream-md img{max-width:100%;height:auto}.stream-md th,.stream-md td{border:1px solid rgb(var(--c-border));padding:.3em .6em}.stream-md hr{border:none;border-top:1px solid rgb(var(--c-border));margin:.8em 0}.cv-row[data-v-b30d2ff4]{content-visibility:auto;contain-intrinsic-size:auto 88px}