@aigne/afs-ui 1.11.0-beta.12

package/dist/session.cjs

@@ -0,0 +1,159 @@
+const require_aup_types = require('./aup-types.cjs');
+let node_crypto = require("node:crypto");
+
+//#region src/session.ts
+var Session = class {
+	id;
+	endpoint;
+	created;
+	_resumeToken;
+	_lastActive;
+	_deviceCaps;
+	messages = [];
+	pages = /* @__PURE__ */ new Map();
+	msgCounter = 0;
+	constructor(id, endpoint, caps) {
+		this.id = id;
+		this.endpoint = endpoint;
+		this.created = Date.now();
+		this._resumeToken = (0, node_crypto.randomBytes)(16).toString("hex");
+		this._lastActive = this.created;
+		this._deviceCaps = caps ?? require_aup_types.DEVICE_CAPS_WEB_FULL;
+	}
+	addMessage(input) {
+		if (!input.type || typeof input.type !== "string") throw new Error("Message requires a 'type' field");
+		if (!input.from || typeof input.from !== "string") throw new Error("Message requires a 'from' field");
+		this.msgCounter++;
+		const msg = {
+			...input,
+			id: `msg_${this.msgCounter.toString().padStart(4, "0")}`,
+			type: input.type,
+			from: input.from,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		this.messages.push(msg);
+		this._lastActive = Date.now();
+		return msg;
+	}
+	listMessages() {
+		return [...this.messages];
+	}
+	findMessage(id) {
+		return this.messages.find((m) => m.id === id);
+	}
+	filterMessages(filter) {
+		return this.messages.filter((m) => {
+			if (filter.type && m.type !== filter.type) return false;
+			if (filter.from && m.from !== filter.from) return false;
+			if (filter.ref && m.ref !== filter.ref) return false;
+			return true;
+		});
+	}
+	setPage(id, data) {
+		const existing = this.pages.get(id);
+		const now = Date.now();
+		this.pages.set(id, {
+			content: data.content,
+			format: data.format,
+			layout: data.layout,
+			createdAt: existing?.createdAt ?? now,
+			updatedAt: now
+		});
+		this._lastActive = now;
+	}
+	getPage(id) {
+		return this.pages.get(id);
+	}
+	listPages() {
+		return Array.from(this.pages, ([id, page]) => ({
+			id,
+			page
+		}));
+	}
+	deletePage(id) {
+		this.pages.delete(id);
+	}
+	touch() {
+		this._lastActive = Date.now();
+	}
+	clear() {
+		this.messages = [];
+		this.pages.clear();
+	}
+	toMeta() {
+		return {
+			id: this.id,
+			endpoint: this.endpoint,
+			created: this.created,
+			lastActive: this._lastActive,
+			messageCount: this.messages.length,
+			pageCount: this.pages.size
+		};
+	}
+	get lastActive() {
+		return this._lastActive;
+	}
+	get resumeToken() {
+		return this._resumeToken;
+	}
+	get deviceCaps() {
+		return this._deviceCaps;
+	}
+	/** Update device caps. Validates before accepting. Returns error string or null. */
+	setDeviceCaps(caps) {
+		const err = require_aup_types.validateDeviceCaps(caps);
+		if (err) return err;
+		this._deviceCaps = caps;
+		this._lastActive = Date.now();
+		return null;
+	}
+};
+var SessionManager = class SessionManager {
+	static SESSION_ID_RE = /^[a-f0-9]{16,64}$/i;
+	sessions = /* @__PURE__ */ new Map();
+	create(endpoint, caps) {
+		const id = (0, node_crypto.randomBytes)(8).toString("hex");
+		const session = new Session(id, endpoint, caps);
+		this.sessions.set(id, session);
+		return session;
+	}
+	/** Create (or reclaim) a session with a specific ID — used for sticky reconnect after service restart. */
+	createWithId(id, endpoint, caps) {
+		if (!SessionManager.isValidSessionId(id)) throw new Error("Invalid session id format");
+		const session = new Session(id, endpoint, caps);
+		this.sessions.set(id, session);
+		return session;
+	}
+	get(id) {
+		const session = this.sessions.get(id);
+		if (!session) throw new Error(`Session not found: ${id}`);
+		return session;
+	}
+	list(endpoint) {
+		const all = Array.from(this.sessions.values());
+		if (endpoint) return all.filter((s) => s.endpoint === endpoint);
+		return all;
+	}
+	delete(id) {
+		if (!this.sessions.has(id)) throw new Error(`Session not found: ${id}`);
+		this.sessions.get(id).clear();
+		this.sessions.delete(id);
+	}
+	gc(maxInactiveMs) {
+		const now = Date.now();
+		for (const [id, session] of this.sessions) if (now - session.lastActive > maxInactiveMs) {
+			session.clear();
+			this.sessions.delete(id);
+		}
+	}
+	has(id) {
+		return this.sessions.has(id);
+	}
+	static isValidSessionId(id) {
+		return SessionManager.SESSION_ID_RE.test(id);
+	}
+};
+
+//#endregion
+exports.Session = Session;
+exports.SessionManager = SessionManager;

package/dist/session.d.cts

@@ -0,0 +1,80 @@
+import { DeviceCaps } from "./aup-types.cjs";
+
+//#region src/session.d.ts
+interface Message {
+  id: string;
+  type: string;
+  from: string;
+  timestamp: string;
+  [key: string]: unknown;
+}
+interface MessageFilter {
+  type?: string;
+  from?: string;
+  ref?: string;
+}
+interface PageData {
+  content: string;
+  format: string;
+  layout?: Record<string, string>;
+  createdAt: number;
+  updatedAt: number;
+}
+declare class Session {
+  readonly id: string;
+  readonly endpoint: string;
+  readonly created: number;
+  private readonly _resumeToken;
+  private _lastActive;
+  private _deviceCaps;
+  private messages;
+  private pages;
+  private msgCounter;
+  constructor(id: string, endpoint: string, caps?: DeviceCaps);
+  addMessage(input: Record<string, unknown>): Message;
+  listMessages(): Message[];
+  findMessage(id: string): Message | undefined;
+  filterMessages(filter: MessageFilter): Message[];
+  setPage(id: string, data: {
+    content: string;
+    format: string;
+    layout?: Record<string, string>;
+  }): void;
+  getPage(id: string): PageData | undefined;
+  listPages(): Array<{
+    id: string;
+    page: PageData;
+  }>;
+  deletePage(id: string): void;
+  touch(): void;
+  clear(): void;
+  toMeta(): {
+    id: string;
+    endpoint: string;
+    created: number;
+    lastActive: number;
+    messageCount: number;
+    pageCount: number;
+  };
+  get lastActive(): number;
+  get resumeToken(): string;
+  get deviceCaps(): DeviceCaps;
+  /** Update device caps. Validates before accepting. Returns error string or null. */
+  setDeviceCaps(caps: unknown): string | null;
+}
+declare class SessionManager {
+  private static readonly SESSION_ID_RE;
+  private sessions;
+  create(endpoint: string, caps?: DeviceCaps): Session;
+  /** Create (or reclaim) a session with a specific ID — used for sticky reconnect after service restart. */
+  createWithId(id: string, endpoint: string, caps?: DeviceCaps): Session;
+  get(id: string): Session;
+  list(endpoint?: string): Session[];
+  delete(id: string): void;
+  gc(maxInactiveMs: number): void;
+  has(id: string): boolean;
+  static isValidSessionId(id: string): boolean;
+}
+//#endregion
+export { Message, MessageFilter, PageData, Session, SessionManager };
+//# sourceMappingURL=session.d.cts.map

package/dist/session.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.cts","names":[],"sources":["../src/session.ts"],"mappings":";;;UAKiB,OAAA;EACf,EAAA;EACA,IAAA;EACA,IAAA;EACA,SAAA;EAAA,CACC,GAAA;AAAA;AAAA,UAGc,aAAA;EACf,IAAA;EACA,IAAA;EACA,GAAA;AAAA;AAAA,UAKe,QAAA;EACf,OAAA;EACA,MAAA;EACA,MAAA,GAAS,MAAA;EACT,SAAA;EACA,SAAA;AAAA;AAAA,cAKW,OAAA;EAAA,SACF,EAAA;EAAA,SACA,QAAA;EAAA,SACA,OAAA;EAAA,iBACQ,YAAA;EAAA,QACT,WAAA;EAAA,QACA,WAAA;EAAA,QACA,QAAA;EAAA,QACA,KAAA;EAAA,QACA,UAAA;cAEI,EAAA,UAAY,QAAA,UAAkB,IAAA,GAAO,UAAA;EAWjD,UAAA,CAAW,KAAA,EAAO,MAAA,oBAA0B,OAAA;EAoB5C,YAAA,CAAA,GAAgB,OAAA;EAIhB,WAAA,CAAY,EAAA,WAAa,OAAA;EAIzB,cAAA,CAAe,MAAA,EAAQ,aAAA,GAAgB,OAAA;EAWvC,OAAA,CAAQ,EAAA,UAAY,IAAA;IAAQ,OAAA;IAAiB,MAAA;IAAgB,MAAA,GAAS,MAAA;EAAA;EAatE,OAAA,CAAQ,EAAA,WAAa,QAAA;EAIrB,SAAA,CAAA,GAAa,KAAA;IAAQ,EAAA;IAAY,IAAA,EAAM,QAAA;EAAA;EAIvC,UAAA,CAAW,EAAA;EAMX,KAAA,CAAA;EAIA,KAAA,CAAA;EAKA,MAAA,CAAA;;;;;;;;MAWI,UAAA,CAAA;EAAA,IAIA,WAAA,CAAA;EAAA,IAMA,UAAA,CAAA,GAAc,UAAA;EA9GV;EAmHR,aAAA,CAAc,IAAA;AAAA;AAAA,cAWH,cAAA;EAAA,wBACa,aAAA;EAAA,QAChB,QAAA;EAER,MAAA,CAAO,QAAA,UAAkB,IAAA,GAAO,UAAA,GAAa,OAAA;EApH7C;EA4HA,YAAA,CAAa,EAAA,UAAY,QAAA,UAAkB,IAAA,GAAO,UAAA,GAAa,OAAA;EAS/D,GAAA,CAAI,EAAA,WAAa,OAAA;EAMjB,IAAA,CAAK,QAAA,YAAoB,OAAA;EAMzB,MAAA,CAAO,EAAA;EAMP,EAAA,CAAG,aAAA;EAUH,GAAA,CAAI,EAAA;EAAA,OAIG,gBAAA,CAAiB,EAAA;AAAA"}

package/dist/session.d.mts

@@ -0,0 +1,80 @@
+import { DeviceCaps } from "./aup-types.mjs";
+
+//#region src/session.d.ts
+interface Message {
+  id: string;
+  type: string;
+  from: string;
+  timestamp: string;
+  [key: string]: unknown;
+}
+interface MessageFilter {
+  type?: string;
+  from?: string;
+  ref?: string;
+}
+interface PageData {
+  content: string;
+  format: string;
+  layout?: Record<string, string>;
+  createdAt: number;
+  updatedAt: number;
+}
+declare class Session {
+  readonly id: string;
+  readonly endpoint: string;
+  readonly created: number;
+  private readonly _resumeToken;
+  private _lastActive;
+  private _deviceCaps;
+  private messages;
+  private pages;
+  private msgCounter;
+  constructor(id: string, endpoint: string, caps?: DeviceCaps);
+  addMessage(input: Record<string, unknown>): Message;
+  listMessages(): Message[];
+  findMessage(id: string): Message | undefined;
+  filterMessages(filter: MessageFilter): Message[];
+  setPage(id: string, data: {
+    content: string;
+    format: string;
+    layout?: Record<string, string>;
+  }): void;
+  getPage(id: string): PageData | undefined;
+  listPages(): Array<{
+    id: string;
+    page: PageData;
+  }>;
+  deletePage(id: string): void;
+  touch(): void;
+  clear(): void;
+  toMeta(): {
+    id: string;
+    endpoint: string;
+    created: number;
+    lastActive: number;
+    messageCount: number;
+    pageCount: number;
+  };
+  get lastActive(): number;
+  get resumeToken(): string;
+  get deviceCaps(): DeviceCaps;
+  /** Update device caps. Validates before accepting. Returns error string or null. */
+  setDeviceCaps(caps: unknown): string | null;
+}
+declare class SessionManager {
+  private static readonly SESSION_ID_RE;
+  private sessions;
+  create(endpoint: string, caps?: DeviceCaps): Session;
+  /** Create (or reclaim) a session with a specific ID — used for sticky reconnect after service restart. */
+  createWithId(id: string, endpoint: string, caps?: DeviceCaps): Session;
+  get(id: string): Session;
+  list(endpoint?: string): Session[];
+  delete(id: string): void;
+  gc(maxInactiveMs: number): void;
+  has(id: string): boolean;
+  static isValidSessionId(id: string): boolean;
+}
+//#endregion
+export { Message, MessageFilter, PageData, Session, SessionManager };
+//# sourceMappingURL=session.d.mts.map

package/dist/session.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.mts","names":[],"sources":["../src/session.ts"],"mappings":";;;UAKiB,OAAA;EACf,EAAA;EACA,IAAA;EACA,IAAA;EACA,SAAA;EAAA,CACC,GAAA;AAAA;AAAA,UAGc,aAAA;EACf,IAAA;EACA,IAAA;EACA,GAAA;AAAA;AAAA,UAKe,QAAA;EACf,OAAA;EACA,MAAA;EACA,MAAA,GAAS,MAAA;EACT,SAAA;EACA,SAAA;AAAA;AAAA,cAKW,OAAA;EAAA,SACF,EAAA;EAAA,SACA,QAAA;EAAA,SACA,OAAA;EAAA,iBACQ,YAAA;EAAA,QACT,WAAA;EAAA,QACA,WAAA;EAAA,QACA,QAAA;EAAA,QACA,KAAA;EAAA,QACA,UAAA;cAEI,EAAA,UAAY,QAAA,UAAkB,IAAA,GAAO,UAAA;EAWjD,UAAA,CAAW,KAAA,EAAO,MAAA,oBAA0B,OAAA;EAoB5C,YAAA,CAAA,GAAgB,OAAA;EAIhB,WAAA,CAAY,EAAA,WAAa,OAAA;EAIzB,cAAA,CAAe,MAAA,EAAQ,aAAA,GAAgB,OAAA;EAWvC,OAAA,CAAQ,EAAA,UAAY,IAAA;IAAQ,OAAA;IAAiB,MAAA;IAAgB,MAAA,GAAS,MAAA;EAAA;EAatE,OAAA,CAAQ,EAAA,WAAa,QAAA;EAIrB,SAAA,CAAA,GAAa,KAAA;IAAQ,EAAA;IAAY,IAAA,EAAM,QAAA;EAAA;EAIvC,UAAA,CAAW,EAAA;EAMX,KAAA,CAAA;EAIA,KAAA,CAAA;EAKA,MAAA,CAAA;;;;;;;;MAWI,UAAA,CAAA;EAAA,IAIA,WAAA,CAAA;EAAA,IAMA,UAAA,CAAA,GAAc,UAAA;EA9GV;EAmHR,aAAA,CAAc,IAAA;AAAA;AAAA,cAWH,cAAA;EAAA,wBACa,aAAA;EAAA,QAChB,QAAA;EAER,MAAA,CAAO,QAAA,UAAkB,IAAA,GAAO,UAAA,GAAa,OAAA;EApH7C;EA4HA,YAAA,CAAa,EAAA,UAAY,QAAA,UAAkB,IAAA,GAAO,UAAA,GAAa,OAAA;EAS/D,GAAA,CAAI,EAAA,WAAa,OAAA;EAMjB,IAAA,CAAK,QAAA,YAAoB,OAAA;EAMzB,MAAA,CAAO,EAAA;EAMP,EAAA,CAAG,aAAA;EAUH,GAAA,CAAI,EAAA;EAAA,OAIG,gBAAA,CAAiB,EAAA;AAAA"}

package/dist/session.mjs

@@ -0,0 +1,159 @@
+import { DEVICE_CAPS_WEB_FULL, validateDeviceCaps } from "./aup-types.mjs";
+import { randomBytes } from "node:crypto";
+
+//#region src/session.ts
+var Session = class {
+	id;
+	endpoint;
+	created;
+	_resumeToken;
+	_lastActive;
+	_deviceCaps;
+	messages = [];
+	pages = /* @__PURE__ */ new Map();
+	msgCounter = 0;
+	constructor(id, endpoint, caps) {
+		this.id = id;
+		this.endpoint = endpoint;
+		this.created = Date.now();
+		this._resumeToken = randomBytes(16).toString("hex");
+		this._lastActive = this.created;
+		this._deviceCaps = caps ?? DEVICE_CAPS_WEB_FULL;
+	}
+	addMessage(input) {
+		if (!input.type || typeof input.type !== "string") throw new Error("Message requires a 'type' field");
+		if (!input.from || typeof input.from !== "string") throw new Error("Message requires a 'from' field");
+		this.msgCounter++;
+		const msg = {
+			...input,
+			id: `msg_${this.msgCounter.toString().padStart(4, "0")}`,
+			type: input.type,
+			from: input.from,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		this.messages.push(msg);
+		this._lastActive = Date.now();
+		return msg;
+	}
+	listMessages() {
+		return [...this.messages];
+	}
+	findMessage(id) {
+		return this.messages.find((m) => m.id === id);
+	}
+	filterMessages(filter) {
+		return this.messages.filter((m) => {
+			if (filter.type && m.type !== filter.type) return false;
+			if (filter.from && m.from !== filter.from) return false;
+			if (filter.ref && m.ref !== filter.ref) return false;
+			return true;
+		});
+	}
+	setPage(id, data) {
+		const existing = this.pages.get(id);
+		const now = Date.now();
+		this.pages.set(id, {
+			content: data.content,
+			format: data.format,
+			layout: data.layout,
+			createdAt: existing?.createdAt ?? now,
+			updatedAt: now
+		});
+		this._lastActive = now;
+	}
+	getPage(id) {
+		return this.pages.get(id);
+	}
+	listPages() {
+		return Array.from(this.pages, ([id, page]) => ({
+			id,
+			page
+		}));
+	}
+	deletePage(id) {
+		this.pages.delete(id);
+	}
+	touch() {
+		this._lastActive = Date.now();
+	}
+	clear() {
+		this.messages = [];
+		this.pages.clear();
+	}
+	toMeta() {
+		return {
+			id: this.id,
+			endpoint: this.endpoint,
+			created: this.created,
+			lastActive: this._lastActive,
+			messageCount: this.messages.length,
+			pageCount: this.pages.size
+		};
+	}
+	get lastActive() {
+		return this._lastActive;
+	}
+	get resumeToken() {
+		return this._resumeToken;
+	}
+	get deviceCaps() {
+		return this._deviceCaps;
+	}
+	/** Update device caps. Validates before accepting. Returns error string or null. */
+	setDeviceCaps(caps) {
+		const err = validateDeviceCaps(caps);
+		if (err) return err;
+		this._deviceCaps = caps;
+		this._lastActive = Date.now();
+		return null;
+	}
+};
+var SessionManager = class SessionManager {
+	static SESSION_ID_RE = /^[a-f0-9]{16,64}$/i;
+	sessions = /* @__PURE__ */ new Map();
+	create(endpoint, caps) {
+		const id = randomBytes(8).toString("hex");
+		const session = new Session(id, endpoint, caps);
+		this.sessions.set(id, session);
+		return session;
+	}
+	/** Create (or reclaim) a session with a specific ID — used for sticky reconnect after service restart. */
+	createWithId(id, endpoint, caps) {
+		if (!SessionManager.isValidSessionId(id)) throw new Error("Invalid session id format");
+		const session = new Session(id, endpoint, caps);
+		this.sessions.set(id, session);
+		return session;
+	}
+	get(id) {
+		const session = this.sessions.get(id);
+		if (!session) throw new Error(`Session not found: ${id}`);
+		return session;
+	}
+	list(endpoint) {
+		const all = Array.from(this.sessions.values());
+		if (endpoint) return all.filter((s) => s.endpoint === endpoint);
+		return all;
+	}
+	delete(id) {
+		if (!this.sessions.has(id)) throw new Error(`Session not found: ${id}`);
+		this.sessions.get(id).clear();
+		this.sessions.delete(id);
+	}
+	gc(maxInactiveMs) {
+		const now = Date.now();
+		for (const [id, session] of this.sessions) if (now - session.lastActive > maxInactiveMs) {
+			session.clear();
+			this.sessions.delete(id);
+		}
+	}
+	has(id) {
+		return this.sessions.has(id);
+	}
+	static isValidSessionId(id) {
+		return SessionManager.SESSION_ID_RE.test(id);
+	}
+};
+
+//#endregion
+export { Session, SessionManager };
+//# sourceMappingURL=session.mjs.map

package/dist/session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.mjs","names":[],"sources":["../src/session.ts"],"sourcesContent":["import { randomBytes } from \"node:crypto\";\nimport { DEVICE_CAPS_WEB_FULL, type DeviceCaps, validateDeviceCaps } from \"./aup-types.js\";\n\n// ── Message ──\n\nexport interface Message {\n  id: string;\n  type: string;\n  from: string;\n  timestamp: string;\n  [key: string]: unknown;\n}\n\nexport interface MessageFilter {\n  type?: string;\n  from?: string;\n  ref?: string;\n}\n\n// ── Page ──\n\nexport interface PageData {\n  content: string;\n  format: string;\n  layout?: Record<string, string>;\n  createdAt: number;\n  updatedAt: number;\n}\n\n// ── Session ──\n\nexport class Session {\n  readonly id: string;\n  readonly endpoint: string;\n  readonly created: number;\n  private readonly _resumeToken: string;\n  private _lastActive: number;\n  private _deviceCaps: DeviceCaps;\n  private messages: Message[] = [];\n  private pages = new Map<string, PageData>();\n  private msgCounter = 0;\n\n  constructor(id: string, endpoint: string, caps?: DeviceCaps) {\n    this.id = id;\n    this.endpoint = endpoint;\n    this.created = Date.now();\n    this._resumeToken = randomBytes(16).toString(\"hex\");\n    this._lastActive = this.created;\n    this._deviceCaps = caps ?? DEVICE_CAPS_WEB_FULL;\n  }\n\n  // ── Messages ──\n\n  addMessage(input: Record<string, unknown>): Message {\n    if (!input.type || typeof input.type !== \"string\") {\n      throw new Error(\"Message requires a 'type' field\");\n    }\n    if (!input.from || typeof input.from !== \"string\") {\n      throw new Error(\"Message requires a 'from' field\");\n    }\n    this.msgCounter++;\n    const msg: Message = {\n      ...input,\n      id: `msg_${this.msgCounter.toString().padStart(4, \"0\")}`,\n      type: input.type as string,\n      from: input.from as string,\n      timestamp: new Date().toISOString(),\n    };\n    this.messages.push(msg);\n    this._lastActive = Date.now();\n    return msg;\n  }\n\n  listMessages(): Message[] {\n    return [...this.messages];\n  }\n\n  findMessage(id: string): Message | undefined {\n    return this.messages.find((m) => m.id === id);\n  }\n\n  filterMessages(filter: MessageFilter): Message[] {\n    return this.messages.filter((m) => {\n      if (filter.type && m.type !== filter.type) return false;\n      if (filter.from && m.from !== filter.from) return false;\n      if (filter.ref && m.ref !== filter.ref) return false;\n      return true;\n    });\n  }\n\n  // ── Pages ──\n\n  setPage(id: string, data: { content: string; format: string; layout?: Record<string, string> }) {\n    const existing = this.pages.get(id);\n    const now = Date.now();\n    this.pages.set(id, {\n      content: data.content,\n      format: data.format,\n      layout: data.layout,\n      createdAt: existing?.createdAt ?? now,\n      updatedAt: now,\n    });\n    this._lastActive = now;\n  }\n\n  getPage(id: string): PageData | undefined {\n    return this.pages.get(id);\n  }\n\n  listPages(): Array<{ id: string; page: PageData }> {\n    return Array.from(this.pages, ([id, page]) => ({ id, page }));\n  }\n\n  deletePage(id: string) {\n    this.pages.delete(id);\n  }\n\n  // ── Lifecycle ──\n\n  touch() {\n    this._lastActive = Date.now();\n  }\n\n  clear() {\n    this.messages = [];\n    this.pages.clear();\n  }\n\n  toMeta() {\n    return {\n      id: this.id,\n      endpoint: this.endpoint,\n      created: this.created,\n      lastActive: this._lastActive,\n      messageCount: this.messages.length,\n      pageCount: this.pages.size,\n    };\n  }\n\n  get lastActive(): number {\n    return this._lastActive;\n  }\n\n  get resumeToken(): string {\n    return this._resumeToken;\n  }\n\n  // ── Device Capabilities (D13) ──\n\n  get deviceCaps(): DeviceCaps {\n    return this._deviceCaps;\n  }\n\n  /** Update device caps. Validates before accepting. Returns error string or null. */\n  setDeviceCaps(caps: unknown): string | null {\n    const err = validateDeviceCaps(caps);\n    if (err) return err;\n    this._deviceCaps = caps as DeviceCaps;\n    this._lastActive = Date.now();\n    return null;\n  }\n}\n\n// ── SessionManager ──\n\nexport class SessionManager {\n  private static readonly SESSION_ID_RE = /^[a-f0-9]{16,64}$/i;\n  private sessions = new Map<string, Session>();\n\n  create(endpoint: string, caps?: DeviceCaps): Session {\n    const id = randomBytes(8).toString(\"hex\");\n    const session = new Session(id, endpoint, caps);\n    this.sessions.set(id, session);\n    return session;\n  }\n\n  /** Create (or reclaim) a session with a specific ID — used for sticky reconnect after service restart. */\n  createWithId(id: string, endpoint: string, caps?: DeviceCaps): Session {\n    if (!SessionManager.isValidSessionId(id)) {\n      throw new Error(\"Invalid session id format\");\n    }\n    const session = new Session(id, endpoint, caps);\n    this.sessions.set(id, session);\n    return session;\n  }\n\n  get(id: string): Session {\n    const session = this.sessions.get(id);\n    if (!session) throw new Error(`Session not found: ${id}`);\n    return session;\n  }\n\n  list(endpoint?: string): Session[] {\n    const all = Array.from(this.sessions.values());\n    if (endpoint) return all.filter((s) => s.endpoint === endpoint);\n    return all;\n  }\n\n  delete(id: string) {\n    if (!this.sessions.has(id)) throw new Error(`Session not found: ${id}`);\n    this.sessions.get(id)!.clear();\n    this.sessions.delete(id);\n  }\n\n  gc(maxInactiveMs: number) {\n    const now = Date.now();\n    for (const [id, session] of this.sessions) {\n      if (now - session.lastActive > maxInactiveMs) {\n        session.clear();\n        this.sessions.delete(id);\n      }\n    }\n  }\n\n  has(id: string): boolean {\n    return this.sessions.has(id);\n  }\n\n  static isValidSessionId(id: string): boolean {\n    return SessionManager.SESSION_ID_RE.test(id);\n  }\n}\n"],"mappings":"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"}

package/dist/snapshot.cjs

@@ -0,0 +1,162 @@
+const require_core = require('./web-page/core.cjs');
+const require_css = require('./web-page/css.cjs');
+const require_icons = require('./web-page/icons.cjs');
+const require_overlay_themes = require('./web-page/overlay-themes.cjs');
+const require_action = require('./web-page/renderers/action.cjs');
+const require_broadcast = require('./web-page/renderers/broadcast.cjs');
+const require_calendar = require('./web-page/renderers/calendar.cjs');
+const require_canvas = require('./web-page/renderers/canvas.cjs');
+const require_cdn_loader = require('./web-page/renderers/cdn-loader.cjs');
+const require_chart = require('./web-page/renderers/chart.cjs');
+const require_deck = require('./web-page/renderers/deck.cjs');
+const require_device = require('./web-page/renderers/device.cjs');
+const require_editor = require('./web-page/renderers/editor.cjs');
+const require_finance_chart = require('./web-page/renderers/finance-chart.cjs');
+const require_frame = require('./web-page/renderers/frame.cjs');
+const require_globe = require('./web-page/renderers/globe.cjs');
+const require_input = require('./web-page/renderers/input.cjs');
+const require_list = require('./web-page/renderers/list.cjs');
+const require_map = require('./web-page/renderers/map.cjs');
+const require_media = require('./web-page/renderers/media.cjs');
+const require_moonphase = require('./web-page/renderers/moonphase.cjs');
+const require_natal_chart = require('./web-page/renderers/natal-chart.cjs');
+const require_overlay = require('./web-page/renderers/overlay.cjs');
+const require_table = require('./web-page/renderers/table.cjs');
+const require_terminal = require('./web-page/renderers/terminal.cjs');
+const require_text = require('./web-page/renderers/text.cjs');
+const require_ticker = require('./web-page/renderers/ticker.cjs');
+const require_time = require('./web-page/renderers/time.cjs');
+const require_unknown = require('./web-page/renderers/unknown.cjs');
+const require_view = require('./web-page/renderers/view.cjs');
+let node_module = require("node:module");
+
+//#region src/snapshot.ts
+/**
+* AUP Snapshot Generator — Freeze an AUP tree into a self-contained HTML file.
+*
+* The snapshot HTML includes:
+* - All CSS (inlined)
+* - All renderer JS (inlined)
+* - AUP tree data (embedded as JSON)
+* - CDN dependencies (marked.js, highlight.js, DOMPurify, Google Fonts)
+* - SEO metadata (og tags, title, description)
+*
+* The snapshot does NOT include:
+* - WebSocket connection code
+* - Session/token management
+* - Input/prompt handling
+* - Chat UI elements
+*/
+const AFS_VERSION = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href)("../package.json").version || "unknown";
+const AFS_VERSION_LITERAL = JSON.stringify(String(AFS_VERSION)).replace(/</g, "\\u003c");
+/** HTML-escape a string for safe embedding in HTML attributes and content */
+function escapeHtml(str) {
+	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#x27;");
+}
+/** Build SEO meta tags for the <head> section */
+function buildSeoTags(slug, meta) {
+	const tags = [];
+	const title = meta?.title || slug;
+	tags.push(`<title>${escapeHtml(title)}</title>`);
+	if (meta?.description) {
+		const desc = meta.description.length > 200 ? `${meta.description.slice(0, 200)}...` : meta.description;
+		tags.push(`<meta name="description" content="${escapeHtml(desc)}">`);
+	}
+	tags.push(`<meta property="og:title" content="${escapeHtml(title)}">`);
+	tags.push(`<meta property="og:type" content="website">`);
+	tags.push(`<meta property="og:url" content="/s/${escapeHtml(slug)}">`);
+	if (meta?.description) {
+		const ogDesc = meta.description.length > 200 ? `${meta.description.slice(0, 200)}...` : meta.description;
+		tags.push(`<meta property="og:description" content="${escapeHtml(ogDesc)}">`);
+	}
+	if (meta?.image && /^https?:\/\//i.test(meta.image)) tags.push(`<meta property="og:image" content="${escapeHtml(meta.image)}">`);
+	return tags.join("\n");
+}
+/** Generate a self-contained HTML snapshot of an AUP tree */
+function generateSnapshot(options) {
+	const { tree, slug, meta, style, locale } = options;
+	const treeJson = JSON.stringify(tree).replace(/<\/script>/gi, "<\\/script>");
+	const seoTags = buildSeoTags(slug, meta);
+	return `<!DOCTYPE html>
+<html lang="${locale ? escapeHtml(locale) : "en"}">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+${seoTags}
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=DM+Sans:opsz,wght@9..40,400;9..40,500;9..40,600;9..40,700&family=Manrope:wght@400;500;600;700&family=Sora:wght@300;400;500;600;700&family=Outfit:wght@400;500;600;700&family=Share+Tech+Mono&family=JetBrains+Mono:wght@400;500&family=DM+Serif+Display:ital@0;1&family=Noto+Sans+SC:wght@300;400;500;600&family=Space+Mono:ital,wght@0,400;0,700;1,400&family=Instrument+Serif:ital@0;1&family=Playfair+Display:ital,wght@0,400;0,700;0,900;1,400&family=Plus+Jakarta+Sans:wght@400;500;600;700;800&family=Fraunces:ital,opsz,wght@0,9..144,400;0,9..144,700;1,9..144,400&family=Crimson+Pro:ital,wght@0,400;0,600;1,400&display=swap" rel="stylesheet">
+<script src="https://cdn.jsdelivr.net/npm/marked@15/marked.min.js"><\/script>
+<script src="https://cdn.jsdelivr.net/npm/marked-highlight@2/lib/index.umd.min.js"><\/script>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11/build/styles/github-dark-dimmed.min.css">
+<script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11/build/highlight.min.js"><\/script>
+<script src="https://cdn.jsdelivr.net/npm/dompurify@3/dist/purify.min.js"><\/script>
+<style>
+${require_css.CSS}
+</style>
+</head>
+<body>
+<div id="aup-display" class="active full-page" style="display:flex">
+<div id="aup-root" class="aup-animating"></div>
+</div>
+<script>
+(function() {
+var _AFS_VERSION = ${AFS_VERSION_LITERAL};
+var _SNAPSHOT_MODE = true;
+${require_core.CORE_HEAD_JS}
+${require_icons.ICONS_JS}
+
+${require_view.VIEW_JS}
+${require_text.TEXT_JS}
+${require_action.ACTION_JS}
+${require_input.INPUT_JS}
+${require_media.MEDIA_JS}
+${require_overlay.OVERLAY_JS}
+${require_table.TABLE_JS}
+${require_terminal.TERMINAL_JS}
+${require_cdn_loader.CDN_LOADER_JS}
+${require_time.TIME_JS}
+${require_chart.CHART_JS}
+${require_finance_chart.FINANCE_CHART_JS}
+${require_map.MAP_JS}
+${require_globe.GLOBE_JS}
+${require_calendar.CALENDAR_JS}
+${require_moonphase.MOONPHASE_JS}
+${require_natal_chart.NATAL_CHART_JS}
+${require_editor.EDITOR_JS}
+${require_frame.FRAME_JS}
+${require_canvas.CANVAS_JS}
+${require_ticker.TICKER_JS}
+${require_broadcast.BROADCAST_JS}
+${require_list.LIST_JS}
+${require_device.DEVICE_JS}
+var _OVERLAY_THEMES_CSS = ${JSON.stringify(require_overlay_themes.OVERLAY_THEMES_CSS)};
+${require_overlay_themes.OVERLAY_THEMES_JS}
+var _DECK_SHADOW_CSS = ${JSON.stringify(require_css.DECK_SHADOW_CSS)};
+${require_deck.DECK_JS}
+${require_unknown.UNKNOWN_JS}
+
+// ── Snapshot: static render (no WebSocket) ──
+var aupDisplayEl = document.getElementById("aup-display");
+var aupRootEl = document.getElementById("aup-root");
+var aupNodeTree = ${treeJson};
+
+${style ? `setStyle(${JSON.stringify(style)});` : ""}
+
+function renderAupTree() {
+  if (!aupNodeTree || !aupRootEl) return;
+  aupRootEl.innerHTML = "";
+  var el = renderAupNode(aupNodeTree);
+  if (el) aupRootEl.appendChild(el);
+  aupRootEl.classList.remove("aup-animating");
+}
+
+renderAupTree();
+})();
+<\/script>
+</body>
+</html>`;
+}
+
+//#endregion
+exports.generateSnapshot = generateSnapshot;