@websimai/socket-types 0.0.2 → 0.0.3

package/dist/index.d.mts

@@ -0,0 +1,215 @@
+//#region src/types/utils/index.d.ts
+type Expand<T> = T extends infer O ? { [K in keyof O]: O[K] } : never;
+type KeyValue = Record<string, any>;
+//#endregion
+//#region src/types/collection-api.d.ts
+interface CollectionAPI<T extends string> {
+  getList: <TData extends KeyValue>() => Expand<TData & {
+    readonly id: string;
+    readonly $type: T;
+    readonly created_at: string;
+    readonly updated_at: string;
+    readonly user_id: string;
+    readonly username: string;
+  }>[];
+  create: <TData extends KeyValue>(data: TData) => Promise<Expand<TData & {
+    readonly id: string;
+    readonly $type: T;
+    readonly created_at: string;
+    readonly username: string;
+  }>>;
+  update: <T_Id extends string, TData extends KeyValue>(id: T_Id, data: TData) => Promise<Expand<TData & {
+    readonly id: T_Id;
+    readonly $type: T;
+    readonly created_at: string;
+    readonly username: string;
+  }>>;
+  upsert: <TData extends KeyValue & {
+    id?: T_Id;
+  }, T_Id extends string = string>(data: TData) => Promise<Expand<(TData extends {
+    id: T_Id;
+  } ? TData & KeyValue : TData) & {
+    readonly id: T_Id;
+    readonly $type: T;
+    readonly created_at: string;
+    readonly username: string;
+  }>>;
+  delete: (id: string) => Promise<void>;
+  subscribe: (callback: (records: Expand<KeyValue & {
+    id: string;
+    $type: T;
+    created_at: string;
+    updated_at: string;
+    user_id: string;
+    username: string;
+  }>[]) => void) => () => void;
+  filter: (filters: KeyValue) => CollectionAPI<T>;
+}
+//#endregion
+//#region src/types/peers.d.ts
+type Peers = {
+  readonly [clientId: string]: {
+    readonly avatarUrl: string;
+    readonly username: string;
+  };
+};
+//#endregion
+//#region src/types/query-api.d.ts
+interface QueryAPI<T extends readonly KeyValue[] = readonly KeyValue[]> extends PromiseLike<T> {
+  getList(): Promise<T>;
+  subscribe(callback: (records: T) => void): () => void;
+}
+//#endregion
+//#region src/websim-socket-party.d.ts
+interface WebsimSocketParty {
+  /**
+   * Object containing the client ID, avatar URL, and username of this connected client.
+   */
+  readonly client: {
+    readonly id: string;
+    readonly avatarUrl: `https://${string}/${string}`;
+    readonly username: string;
+  };
+  /**
+   * Object containing all connected peers, including this client.
+   * This is always up-to-date.
+   */
+  readonly peers: {
+    [id: string]: {
+      readonly avatarUrl: `https://${string}/${string}`;
+      readonly username: string;
+      readonly id: string;
+      readonly is_anonymous: boolean;
+    };
+  };
+  subscribe: (callback: (peers: Peers) => void) => () => void;
+  /**
+   * Object containing the current presence state of all connected peers, including this client.
+   * This is always up-to-date after initialization.
+   */
+  readonly presence: KeyValue;
+  /**
+   * Updates the current client's presence state.
+   * @param presence The new presence state to set.
+   */
+  updatePresence<TPresence extends KeyValue>(presence: TPresence): void;
+  /**
+   * Subscribe to presence updates from all peers.
+   * @param callback Function to call when presence changes.
+   * @returns Function to unsubscribe.
+   */
+  subscribePresence<TPresence extends KeyValue>(callback: (presence: {
+    [clientId: string]: TPresence;
+  }) => void): () => void;
+  /**
+   * Object containing the current room-wide state.
+   * This is always up-to-date.
+   */
+  readonly roomState: KeyValue;
+}
+//#endregion
+//#region src/websim-socket.d.ts
+declare class WebsimSocketClass {
+  constructor();
+  readonly CONNECTING: 0;
+  readonly OPEN: 1;
+  readonly CLOSING: 2;
+  readonly CLOSED: 3;
+  readonly binaryType: "arraybuffer" | (string & {});
+  readonly bufferedAmount: number;
+  readonly extensions: string;
+  readonly protocol: "ws" | "wss";
+  readonly readyState: 0 | 1 | 2 | 3;
+  readonly url: string;
+  accept(): void;
+  serializeAttachment(): void;
+  deserializeAttachment(): void;
+  onclose: ((this: WebSocket, ev: CloseEvent) => any) | null;
+  onerror: ((this: WebSocket, ev: Event) => any) | null;
+  onmessage: ((this: WebSocket, ev: MessageEvent) => any) | null;
+  onopen: ((this: WebSocket, ev: Event) => any) | null;
+  dispatchEvent(event: Event | MessageEvent | CloseEvent | ErrorEvent): boolean;
+  close(_code?: number, _reason?: string): void;
+  send<TData extends string | object>(data: TData): void;
+  query<TParams extends unknown = unknown>(queryString: string, params?: TParams[]): QueryAPI;
+  collection<T extends string>($type: T): CollectionAPI<T>;
+  readonly clientId: string;
+  /**
+   * Object containing information about the connected client and their peers.
+   */
+  readonly party: WebsimSocketParty;
+  /**
+   * Legacy event handler for changes in connected peers.
+   * @param peers An object with client IDs as keys, each containing the client's avatar URL and username.
+   */
+  onPeersChanged: ((peers: Peers) => any) | null;
+  /**
+   * Initialize the WebSocket connection.
+   * @returns A promise that resolves when initialization is complete.
+   */
+  initialize(): Promise<void>;
+  /**
+   * Request a presence update from a specific client.
+   * @param clientId The ID of the client to request an update from.
+   * @param update The update to request.
+   */
+  requestPresenceUpdate(clientId: string, update: KeyValue): void;
+  /**
+   * Subscribe to presence update requests from other clients.
+   * @param callback Function to call when a presence update is requested.
+   * @returns Function to unsubscribe.
+   */
+  subscribePresenceUpdateRequests<TUpdateRequest extends KeyValue>(callback: (updateRequest: TUpdateRequest, fromClientId: string) => void): () => void;
+  /**
+   * Updates the room-wide state. This merges with existing state.
+   * @param delta The new state to merge with current room state.
+   */
+  updateRoomState<TDelta extends KeyValue>(delta: TDelta): void;
+  /**
+   * Subscribe to room state updates.
+   * @param callback Function to call when room state changes.
+   * @returns Function to unsubscribe.
+   */
+  subscribeRoomState<TRoomState extends KeyValue>(callback: (state: TRoomState) => void): () => void;
+  /**
+   * Object containing the current presence state of all connected peers, including this client.
+   * This is always up-to-date after initialization.
+   */
+  readonly presence: {
+    [clientId: string]: KeyValue;
+  };
+  /**
+   * Object containing the current room-wide state.
+   * This is always up-to-date.
+   */
+  readonly roomState: KeyValue;
+  /**
+   * Object containing all connected peers, including this client.
+   * This is always up-to-date.
+   */
+  readonly peers: Peers;
+  /**
+   * Updates the current client's presence state.
+   * @param presence The new presence state to set.
+   */
+  updatePresence<TPresence extends KeyValue>(presence: TPresence): void;
+  /**
+   * Subscribe to presence updates from all peers.
+   * @param callback Function to call when presence changes.
+   * @returns Function to unsubscribe.
+   */
+  subscribePresence<TPresence extends KeyValue>(callback: (presence: {
+    [clientId: string]: TPresence;
+  }) => void): () => void;
+}
+//#endregion
+//#region src/globals.d.ts
+type WebsimSocketConstructor = typeof WebsimSocketClass;
+declare global {
+  interface Window {
+    readonly WebsimSocket: WebsimSocketConstructor;
+  }
+  const WebsimSocket: WebsimSocketConstructor;
+}
+//#endregion
+export { type CollectionAPI, type QueryAPI, type WebsimSocketClass };

package/dist/index.mjs

@@ -0,0 +1 @@
+export {  };

package/package.json

@@ -1,24 +1,40 @@
 {
   "name": "@websimai/socket-types",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Type declarations for the `WebsimSocket` class",
+  "type": "module",
   "author": "GameRoMan",
   "license": "MIT",
-  "types": "./src/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./src/index.d.ts"
-    }
+  "publishConfig": {
+    "access": "public"
   },
-  "scripts": {
-    "npm:publish": "bun publish --access public"
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/websimnpm/websim.git",
+    "directory": "packages/socket-api-types"
   },
   "keywords": [
     "websim",
     "types",
     "typescript"
   ],
-  "peerDependencies": {
-    "typescript": "^5.9.2"
+  "scripts": {
+    "build": "bunx --bun tsdown",
+    "npm:publish": "bun run build && bun publish"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "devDependencies": {
+    "tsdown": "^0.17.3"
   }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Roman A
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/src/globals.d.ts

@@ -1,13 +0,0 @@
-import { WebsimSocket as WebsimSocketClass } from "./websim-socket";
-
-type WebsimSocketConstructor = typeof WebsimSocketClass;
-
-declare global {
-  interface Window {
-    readonly WebsimSocket: WebsimSocketConstructor;
-  }
-
-  const WebsimSocket: WebsimSocketConstructor;
-
-  type WebsimSocket = WebsimSocketClass;
-}

package/src/index.d.ts

@@ -1,4 +0,0 @@
-export type { WebsimSocket } from "./websim-socket";
-export type * from "./types";
-
-export type * from "./globals";

package/src/types/collection-api.d.ts

@@ -1,70 +0,0 @@
-import type { KeyValue, Expand } from "./utils";
-
-export interface CollectionAPI<T extends string> {
-  getList: <TData extends KeyValue>() => Expand<
-    TData & {
-      readonly id: string;
-      readonly $type: T;
-      readonly created_at: string;
-      readonly updated_at: string;
-      readonly user_id: string;
-      readonly username: string;
-    }
-  >[];
-  create: <TData extends KeyValue>(
-    data: TData
-  ) => Promise<
-    Expand<
-      TData & {
-        readonly id: string;
-        readonly $type: T;
-        readonly created_at: string;
-        readonly username: string;
-      }
-    >
-  >;
-  update: <T_Id extends string, TData extends KeyValue>(
-    id: T_Id,
-    data: TData
-  ) => Promise<
-    Expand<
-      TData & {
-        readonly id: T_Id;
-        readonly $type: T;
-        readonly created_at: string;
-        readonly username: string;
-      }
-    >
-  >;
-  upsert: <
-    TData extends KeyValue & { id?: T_Id },
-    T_Id extends string = string
-  >(
-    data: TData
-  ) => Promise<
-    Expand<
-      (TData extends { id: T_Id } ? TData & KeyValue : TData) & {
-        readonly id: T_Id;
-        readonly $type: T;
-        readonly created_at: string;
-        readonly username: string;
-      }
-    >
-  >;
-  delete: (id: string) => Promise<void>;
-  subscribe: (
-    callback: (
-      records: Expand<
-        KeyValue & {
-          id: string;
-          $type: T;
-          created_at: string;
-          updated_at: string;
-          user_id: string;
-          username: string;
-        }
-      >[]
-    ) => void
-  ) => () => void;
-  filter: (filters: KeyValue) => CollectionAPI<T>;
-}

package/src/types/index.d.ts

@@ -1,2 +0,0 @@
-export type * from "./collection-api";
-export type * from "./query-api";

package/src/types/query-api.d.ts

@@ -1,7 +0,0 @@
-import type { KeyValue } from "./utils";
-
-export interface QueryAPI<T extends readonly KeyValue[] = readonly KeyValue[]>
-  extends PromiseLike<T> {
-  getList(): Promise<T>;
-  subscribe(callback: (records: T) => void): () => void;
-}

package/src/types/utils/index.d.ts

@@ -1,3 +0,0 @@
-export type Expand<T> = T extends infer O ? { [K in keyof O]: O[K] } : never;
-
-export type KeyValue = Record<string, any>;

package/src/websim-socket-party.d.ts

@@ -1,61 +0,0 @@
-import type { KeyValue } from "./types/utils";
-
-export interface WebsimSocketParty {
-  /**
-   * Object containing the client ID, avatar URL, and username of this connected client.
-   */
-  readonly client: {
-    readonly id: string;
-    readonly avatarUrl: `https://${string}/${string}`;
-    readonly username: string;
-  };
-
-  /**
-   * Object containing all connected peers, including this client.
-   * This is always up-to-date.
-   */
-  readonly peers: {
-    [id: string]: {
-      readonly avatarUrl: `https://${string}/${string}`;
-      readonly username: string;
-      readonly id: string;
-      readonly is_anonymous: boolean;
-    };
-  };
-
-  subscribe: (
-    callback: (peers: {
-      [clientId: string]: {
-        avatarUrl: string;
-        username: string;
-      };
-    }) => void
-  ) => () => void;
-
-  /**
-   * Object containing the current presence state of all connected peers, including this client.
-   * This is always up-to-date after initialization.
-   */
-  readonly presence: KeyValue;
-
-  /**
-   * Updates the current client's presence state.
-   * @param presence The new presence state to set.
-   */
-  updatePresence<TPresence extends KeyValue>(presence: TPresence): void;
-
-  /**
-   * Subscribe to presence updates from all peers.
-   * @param callback Function to call when presence changes.
-   * @returns Function to unsubscribe.
-   */
-  subscribePresence<TPresence extends KeyValue>(
-    callback: (presence: { [clientId: string]: TPresence }) => void
-  ): () => void;
-
-  /**
-   * Object containing the current room-wide state.
-   * This is always up-to-date.
-   */
-  readonly roomState: KeyValue;
-}

package/src/websim-socket.d.ts

@@ -1,134 +0,0 @@
-import type { KeyValue } from "./types/utils";
-
-import type { WebsimSocketParty } from "./websim-socket-party";
-
-import type { CollectionAPI, QueryAPI } from "./types";
-
-export class WebsimSocket {
-  constructor();
-
-  readonly CONNECTING: 0;
-  readonly OPEN: 1;
-  readonly CLOSING: 2;
-  readonly CLOSED: 3;
-
-  readonly binaryType: "arraybuffer" | (string & {});
-  readonly bufferedAmount: number;
-  readonly extensions: string;
-  readonly protocol: "ws" | "wss";
-  readonly readyState: 0 | 1 | 2 | 3;
-  readonly url: string;
-
-  accept(): void;
-  serializeAttachment(): void;
-  deserializeAttachment(): void;
-
-  onclose: ((this: WebSocket, ev: CloseEvent) => any) | null;
-  onerror: ((this: WebSocket, ev: Event) => any) | null;
-  onmessage: ((this: WebSocket, ev: MessageEvent) => any) | null;
-  onopen: ((this: WebSocket, ev: Event) => any) | null;
-
-  dispatchEvent(event: Event | MessageEvent | CloseEvent | ErrorEvent): boolean;
-
-  close(_code?: number, _reason?: string): void;
-  send<TData extends string | object>(data: TData): void;
-
-  query(queryString: string, params?: any[]): QueryAPI;
-
-  collection<T extends string>($type: T): CollectionAPI<T>;
-
-  readonly clientId: string;
-
-  /**
-   * Object containing information about the connected client and their peers.
-   */
-  readonly party: WebsimSocketParty;
-
-  /**
-   * Legacy event handler for changes in connected peers.
-   * @param peers An object with client IDs as keys, each containing the client's avatar URL and username.
-   */
-  onPeersChanged:
-    | ((peers: {
-        [clientId: string]: {
-          avatarUrl: string;
-          username: string;
-        };
-      }) => any)
-    | null;
-
-  /**
-   * Initialize the WebSocket connection.
-   * @returns A promise that resolves when initialization is complete.
-   */
-  initialize(): Promise<void>;
-
-  /**
-   * Request a presence update from a specific client.
-   * @param clientId The ID of the client to request an update from.
-   * @param update The update to request.
-   */
-  requestPresenceUpdate(clientId: string, update: KeyValue): void;
-
-  /**
-   * Subscribe to presence update requests from other clients.
-   * @param callback Function to call when a presence update is requested.
-   * @returns Function to unsubscribe.
-   */
-  subscribePresenceUpdateRequests<TUpdateRequest extends KeyValue>(
-    callback: (updateRequest: TUpdateRequest, fromClientId: string) => void
-  ): () => void;
-
-  /**
-   * Updates the room-wide state. This merges with existing state.
-   * @param delta The new state to merge with current room state.
-   */
-  updateRoomState<TDelta extends KeyValue>(delta: TDelta): void;
-
-  /**
-   * Subscribe to room state updates.
-   * @param callback Function to call when room state changes.
-   * @returns Function to unsubscribe.
-   */
-  subscribeRoomState<TRoomState extends KeyValue>(
-    callback: (state: TRoomState) => void
-  ): () => void;
-
-  /**
-   * Object containing the current presence state of all connected peers, including this client.
-   * This is always up-to-date after initialization.
-   */
-  readonly presence: { [clientId: string]: KeyValue };
-
-  /**
-   * Object containing the current room-wide state.
-   * This is always up-to-date.
-   */
-  readonly roomState: KeyValue;
-
-  /**
-   * Object containing all connected peers, including this client.
-   * This is always up-to-date.
-   */
-  readonly peers: {
-    [clientId: string]: {
-      avatarUrl: string;
-      username: string;
-    };
-  };
-
-  /**
-   * Updates the current client's presence state.
-   * @param presence The new presence state to set.
-   */
-  updatePresence<TPresence extends KeyValue>(presence: TPresence): void;
-
-  /**
-   * Subscribe to presence updates from all peers.
-   * @param callback Function to call when presence changes.
-   * @returns Function to unsubscribe.
-   */
-  subscribePresence<TPresence extends KeyValue>(
-    callback: (presence: { [clientId: string]: TPresence }) => void
-  ): () => void;
-}

package/tsconfig.json

@@ -1,31 +0,0 @@
-{
-  "compilerOptions": {
-    // Environment setup & latest features
-    "lib": ["ESNext", "DOM"],
-    "target": "esnext",
-    "module": "preserve",
-    "moduleDetection": "force",
-
-    // Bundler mode
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "noEmit": true,
-
-    // This is a type declarations package
-    "skipLibCheck": false,
-    "skipDefaultLibCheck": true,
-
-    // Max strictness
-    "strict": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitOverride": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noPropertyAccessFromIndexSignature": true,
-    "noImplicitAny": true,
-    "strictNullChecks": true,
-    "forceConsistentCasingInFileNames": true,
-    "verbatimModuleSyntax": true
-  }
-}