npm - @ganglion/xacpx-relay - Versions diffs - 0.1.0 - Mend

@ganglion/xacpx-relay 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (98) hide show

package/dist/relay-web/assets/inter-greek-400-normal-B4URO6DV.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-400-normal-q2sYcFCs.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-500-normal-BIZE56-Y.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-500-normal-Xzm54t5V.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-600-normal-BZpKdvQh.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-600-normal-plRanbMR.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-700-normal-BUv2fZ6O.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-700-normal-C3JjAnD8.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-ext-400-normal-DGGRlc-M.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-ext-400-normal-KugGGMne.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-ext-500-normal-2j5mBUwD.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-ext-500-normal-C4iEst2y.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-ext-600-normal-B8X0CLgF.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-ext-600-normal-DRtmH8MT.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-ext-700-normal-BoQ6DsYi.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-greek-ext-700-normal-qfdV9bQt.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-400-normal-C38fXH4l.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-400-normal-CyCys3Eg.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-500-normal-BL9OpVg8.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-500-normal-Cerq10X2.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-600-normal-CiBQ2DWP.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-600-normal-LgqL8muc.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-700-normal-BLAVimhd.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-700-normal-Yt3aPRUw.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-ext-400-normal-77YHD8bZ.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-ext-400-normal-C1nco2VV.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-ext-500-normal-BxGbmqWO.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-ext-500-normal-CV4jyFjo.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-ext-600-normal-CIVaiw4L.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-ext-600-normal-D2bJ5OIk.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-ext-700-normal-Ca8adRJv.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-latin-ext-700-normal-TidjK2hL.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-vietnamese-400-normal-Bbgyi5SW.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-vietnamese-400-normal-DMkecbls.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-vietnamese-500-normal-DOriooB6.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-vietnamese-500-normal-mJboJaSs.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-vietnamese-600-normal-BuLX-rYi.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-vietnamese-600-normal-Cc8MFFhd.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-vietnamese-700-normal-BZaoP0fm.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/inter-vietnamese-700-normal-DlLaEgI2.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-cyrillic-400-normal-BEIGL1Tu.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-cyrillic-400-normal-ugxPyKxw.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-cyrillic-500-normal-DJqRU3vO.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-cyrillic-500-normal-DmUKJPL_.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-greek-400-normal-B9oWc5Lo.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-greek-400-normal-C190GLew.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-greek-500-normal-D7SFKleX.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-greek-500-normal-JpySY46c.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-latin-400-normal-6-qcROiO.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-latin-400-normal-V6pRDFza.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-latin-500-normal-BWZEU5yA.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-latin-500-normal-CJOVTJB7.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-latin-ext-400-normal-Bc8Ftmh3.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-latin-ext-400-normal-fXTG6kC5.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-latin-ext-500-normal-Cut-4mMH.woff2 ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-latin-ext-500-normal-ckzbgY84.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-vietnamese-400-normal-CqNFfHCs.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/jetbrains-mono-vietnamese-500-normal-DNRqzVM1.woff ADDED Viewed

Binary file

package/dist/relay-web/assets/theme-CaepIjgl.js ADDED Viewed

@@ -0,0 +1 @@

+ import{k as n,r as c}from"./index-DE2bTqBl.js";const a="relay-theme";function m(){var t;const e=localStorage.getItem(a);return e==="dark"||e==="light"?e:(t=window.matchMedia)!=null&&t.call(window,"(prefers-color-scheme: light)").matches?"light":"dark"}const i=n("theme",()=>{const e=c(m());function t(){document.documentElement.classList.toggle("dark",e.value==="dark"),document.documentElement.style.colorScheme=e.value}function o(r){e.value=r,localStorage.setItem(a,r),t()}function l(){o(e.value==="dark"?"light":"dark")}return t(),{mode:e,set:o,toggle:l,apply:t}});export{i as u};

package/dist/relay-web/index.html ADDED Viewed

@@ -0,0 +1,28 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>xacpx relay</title>
+    <script>
+      (function () {
+        try {
+          var m = localStorage.getItem('relay-theme');
+          if (m !== 'dark' && m !== 'light') {
+            m = window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark';
+          }
+          document.documentElement.classList.toggle('dark', m === 'dark');
+          document.documentElement.style.colorScheme = m;
+        } catch (e) {
+          document.documentElement.classList.add('dark');
+          document.documentElement.style.colorScheme = 'dark';
+        }
+      })();
+    </script>
+    <script type="module" crossorigin src="/assets/index-DE2bTqBl.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DC1zO5jV.css">
+  </head>
+  <body>
+    <div id="app"></div>
+  </body>
+</html>

package/dist/server.d.ts ADDED Viewed

@@ -0,0 +1,42 @@
+import { type SqlDriver } from "./db.js";
+import { AccountStore } from "./stores/accounts.js";
+import { InstanceStore } from "./stores/instances.js";
+import { MessageStore } from "./stores/messages.js";
+import { InstanceGateway } from "./gateway/instance-gateway.js";
+import { WebGateway } from "./gateway/web-gateway.js";
+import { createApp } from "./http/app.js";
+export interface RelayRuntime {
+    db: SqlDriver;
+    accounts: AccountStore;
+    instances: InstanceStore;
+    messages: MessageStore;
+    gateway: InstanceGateway;
+    webGateway: WebGateway;
+    app: ReturnType<typeof createApp>;
+    close(): void;
+}
+export interface CreateRuntimeOptions {
+    webRoot?: string;
+    historyRetentionDays?: number;
+    requestTimeoutMs?: number;
+    trustProxy?: boolean;
+}
+/** Testable assembly without any network listener. */
+export declare function createRelayRuntime(dbPath: string, options?: CreateRuntimeOptions): Promise<RelayRuntime>;
+export interface StartRelayOptions {
+    dbPath: string;
+    httpPort: number;
+    wsPort: number;
+    host?: string;
+    webRoot?: string;
+    historyRetentionDays?: number;
+    requestTimeoutMs?: number;
+    trustProxy?: boolean;
+}
+export interface RunningRelay {
+    runtime: RelayRuntime;
+    httpPort: number;
+    wsPort: number;
+    close(): Promise<void>;
+}
+export declare function startRelayServer(options: StartRelayOptions): Promise<RunningRelay>;

package/dist/stores/accounts.d.ts ADDED Viewed

@@ -0,0 +1,74 @@
+import type { SqlDriver } from "../db.js";
+export interface AccountRow {
+    id: string;
+    username: string;
+    createdAt: string;
+}
+interface AccountStoreOptions {
+    now?: () => Date;
+}
+export declare class AccountStore {
+    private readonly db;
+    private readonly now;
+    constructor(db: SqlDriver, options?: AccountStoreOptions);
+    createAccount(username: string): AccountRow;
+    findByUsername(username: string): AccountRow | null;
+    findById(id: string): AccountRow | null;
+    listAccounts(): Array<AccountRow & {
+        tokenCount: number;
+        instanceCount: number;
+    }>;
+    countInstances(accountId: string): number;
+    createLoginToken(accountId: string, label?: string): {
+        id: string;
+        token: string;
+    };
+    /**
+     * Single source of truth for login-token resolution: find the token row by
+     * hashed token, confirm the account still exists, THEN bump last_used_at.
+     * The bump happens only after the account is confirmed, so a token whose
+     * account was deleted does not get a wasted last_used_at update. Both
+     * findAccountByLoginToken and resolveLoginToken go through here, so the bump
+     * happens exactly once and identically for both.
+     */
+    private _resolveLoginToken;
+    findAccountByLoginToken(token: string): AccountRow | null;
+    resolveLoginToken(token: string): {
+        account: AccountRow;
+        loginTokenId: string;
+    } | null;
+    listLoginTokens(accountId: string): Array<{
+        id: string;
+        label: string | null;
+        createdAt: string;
+        lastUsedAt: string | null;
+    }>;
+    /**
+     * Returns all login tokens across all accounts, each with its owning account's
+     * total instance count. Intended for the `xacpx-relay ls` command output.
+     */
+    listTokens(): Array<{
+        id: string;
+        label: string | null;
+        createdAt: string;
+        accountId: string;
+        instanceCount: number;
+    }>;
+    /**
+     * Resolves a token value or id/prefix to the owning account_id.
+     * Try order:
+     *   1. Raw token value hash lookup (resolveLoginToken)
+     *   2. Exact id match in login_tokens
+     *   3. Unique prefix match (WHERE id LIKE ? || '%') — accepts only if exactly one row
+     * Returns null if not found or prefix is ambiguous.
+     */
+    accountIdForToken(valueOrId: string): string | null;
+    revokeLoginToken(tokenId: string): boolean;
+    createWebSession(accountId: string, loginTokenId: string, ttlMs: number): string;
+    getSessionAccount(token: string): AccountRow | null;
+    deleteWebSession(token: string): void;
+    deleteAccountCascade(accountId: string): void;
+    /** Deletes expired web sessions. Returns rows removed. */
+    pruneExpired(now: Date): number;
+}
+export {};

package/dist/stores/instances.d.ts ADDED Viewed

@@ -0,0 +1,42 @@
+import type { SqlDriver } from "../db.js";
+export interface InstanceRow {
+    id: string;
+    accountId: string;
+    name: string;
+    coreVersion: string | null;
+    lastSeenAt: string | null;
+    createdAt: string;
+}
+export interface RedeemedInstance {
+    instanceId: string;
+    credential: string;
+    accountId: string;
+    name: string;
+}
+interface InstanceStoreOptions {
+    now?: () => Date;
+}
+export declare class InstanceStore {
+    private readonly db;
+    private readonly now;
+    constructor(db: SqlDriver, options?: InstanceStoreOptions);
+    issuePairingToken(accountId: string, name: string | undefined, ttlMs: number): {
+        token: string;
+        expiresAt: string;
+    };
+    /**
+     * Creates a new instance for an account directly (without a pairing token).
+     * Used when the connector presents a login token instead of a pairing token.
+     */
+    registerInstanceForAccount(accountId: string, name: string | undefined, coreVersion?: string): RedeemedInstance;
+    /** Single-use: marks the token used and creates the instance row atomically-enough for our single-writer server. */
+    redeemPairingToken(token: string, coreVersion?: string): RedeemedInstance | null;
+    verifyCredential(instanceId: string, credential: string): InstanceRow | null;
+    touch(instanceId: string, coreVersion?: string): void;
+    listByAccount(accountId: string): InstanceRow[];
+    getOwned(instanceId: string, accountId: string): InstanceRow | null;
+    remove(instanceId: string, accountId: string): boolean;
+    /** Deletes expired or already-used pairing tokens. Returns rows removed. */
+    prunePairingTokens(now: Date): number;
+}
+export {};

package/dist/stores/messages.d.ts ADDED Viewed

@@ -0,0 +1,30 @@
+import type { MessageDirection, MessageRecordDto } from "@ganglion/xacpx-relay-protocol";
+import type { SqlDriver } from "../db.js";
+type StructuredTurn = NonNullable<MessageRecordDto["structured"]>;
+export interface MessagePage {
+    messages: MessageRecordDto[];
+    /** True when older rows exist beyond this page (drives "load older" on scroll-up). */
+    hasMore: boolean;
+}
+export declare class MessageStore {
+    private readonly db;
+    private readonly now;
+    constructor(db: SqlDriver, now?: () => Date);
+    append(instanceId: string, sessionAlias: string, direction: MessageDirection, text: string, structured?: StructuredTurn): void;
+    /**
+     * One page of a session's history, oldest-first, scoped to the owning account.
+     * Without `before` returns the most recent `limit` rows; with `before` returns the
+     * `limit` rows immediately OLDER than that message id (cursor pagination for
+     * "load older" on scroll-up). `hasMore` reports whether further-back rows exist.
+     */
+    listBySession(accountId: string, instanceId: string, sessionAlias: string, opts?: {
+        limit?: number;
+        before?: number;
+    }): MessagePage;
+    /** Deletes messages older than maxAgeMs and/or beyond the newest maxPerSession per (instance, session). Returns rows deleted. */
+    prune(opts: {
+        maxAgeMs?: number;
+        maxPerSession?: number;
+    }): number;
+}
+export {};

package/package.json ADDED Viewed

@@ -0,0 +1,24 @@
+{
+  "name": "@ganglion/xacpx-relay",
+  "version": "0.1.0",
+  "description": "Self-hosted relay hub for xacpx: instance gateway, accounts, and web API.",
+  "license": "MIT",
+  "keywords": ["xacpx", "relay", "hub"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gadzan/xacpx.git",
+    "directory": "packages/relay"
+  },
+  "type": "module",
+  "main": "./dist/cli.js",
+  "bin": { "xacpx-relay": "./dist/cli.js" },
+  "files": ["dist", "README.md"],
+  "engines": { "node": ">=22.13.0" },
+  "publishConfig": { "access": "public" },
+  "dependencies": {
+    "@ganglion/xacpx-relay-protocol": "^0.1.0",
+    "@hono/node-server": "^1.13.0",
+    "hono": "^4.6.0",
+    "ws": "^8.20.0"
+  }
+}