room-kit 1.0.0

package/dist/index.js

@@ -0,0 +1,5 @@
+export { ClientSafeError } from "./types";
+export { createRoomClient } from "./client";
+export { defineRoomType } from "./room";
+export { serveRoomType } from "./server";
+//# 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,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/room.d.ts

@@ -0,0 +1,24 @@
+import type { RoomDefinition, RoomSchema } from "./types";
+/**
+ * Defines a room type using a type-only schema and runtime options.
+ *
+ * @example
+ * ```ts
+ * const chatRoom = defineRoomType<{
+ *   joinRequest: { roomId: string; roomKey: string; userName: string };
+ *   memberProfile: { userId: string; userName: string };
+ *   roomProfile: { roomId: string; created: string };
+ *   serverState: { roomKey: string; created: string };
+ *   events: { message: { text: string } };
+ *   rpc: { sendMessage: (input: { text: string }) => Promise<void> };
+ * }>({
+ *   name: "chat",
+ *   presence: "count",
+ * });
+ * ```
+ */
+export declare function defineRoomType<TSchema extends RoomSchema, TPresence extends "none" | "count" | "list" = "list">(options: {
+    readonly name: string;
+    readonly presence?: TPresence;
+}): RoomDefinition<TSchema, TPresence>;
+//# sourceMappingURL=room.d.ts.map

package/dist/room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../src/room.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,UAAU,EAAE,SAAS,SAAS,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EAC3G,OAAO,EAAE;IACL,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACjC,GACF,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAMpC"}

package/dist/room.js

@@ -0,0 +1,26 @@
+/**
+ * Defines a room type using a type-only schema and runtime options.
+ *
+ * @example
+ * ```ts
+ * const chatRoom = defineRoomType<{
+ *   joinRequest: { roomId: string; roomKey: string; userName: string };
+ *   memberProfile: { userId: string; userName: string };
+ *   roomProfile: { roomId: string; created: string };
+ *   serverState: { roomKey: string; created: string };
+ *   events: { message: { text: string } };
+ *   rpc: { sendMessage: (input: { text: string }) => Promise<void> };
+ * }>({
+ *   name: "chat",
+ *   presence: "count",
+ * });
+ * ```
+ */
+export function defineRoomType(options) {
+    return {
+        kind: "room",
+        name: options.name,
+        presence: options.presence ?? "list",
+    };
+}
+//# sourceMappingURL=room.js.map

package/dist/room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.js","sourceRoot":"","sources":["../src/room.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAC1B,OAGC;IAED,OAAO;QACH,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM;KACD,CAAC;AAC5C,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,27 @@
+import type { RoomDefinition, RoomServerAdapter, RoomServerHandle, RoomServerHandlers, ServerSocketLike } from "./types";
+/**
+ * Attaches room runtime handlers to a connected server socket.
+ *
+ * Returns a callable handle that unregisters all listeners for the bound
+ * socket, and exposes room introspection helpers.
+ *
+ * @example
+ * ```ts
+ * io.on("connection", (socket) => {
+ *   const stop = serveRoomType(socket, chatRoomType, {
+ *     onAuth: async () => ({ userId: socket.id }),
+ *     admit: async (join, ctx) => ({
+ *       roomId: join.roomId,
+ *       memberId: ctx.auth.userId,
+ *       memberProfile: { userId: ctx.auth.userId, userName: join.userName },
+ *       roomProfile: { roomId: join.roomId, created: new Date().toISOString() },
+ *     }),
+ *   });
+ *
+ *   // Later if needed:
+ *   // stop();
+ * });
+ * ```
+ */
+export declare function serveRoomType<TRoom extends RoomDefinition<any>, TAuth = unknown>(socket: ServerSocketLike, _room: TRoom, handlers: RoomServerHandlers<TRoom, TAuth>, adapter?: RoomServerAdapter): RoomServerHandle<TRoom>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAUR,cAAc,EAEd,iBAAiB,EAEjB,gBAAgB,EAEhB,kBAAkB,EAElB,gBAAgB,EAInB,MAAM,SAAS,CAAC;AAoCjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,KAAK,SAAS,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,EAC5E,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,EAC1C,OAAO,CAAC,EAAE,iBAAiB,GAC5B,gBAAgB,CAAC,KAAK,CAAC,CAyVzB"}