@jomkv/keybud-v2-contracts 1.0.0 → 1.0.2

package/README.md

@@ -1,10 +1,11 @@
 # KeyBud V2 Contracts
 
-Shared TypeScript contracts and type definitions for KeyBud V2, providing type-safe communication between frontend and backend applications.
+Shared TypeScript contracts and type definitions for KeyBud V2.
 
 ## Overview
 
-This package contains shared contracts for WebSocket events, payloads, and other common types used across the KeyBud V2 ecosystem. It ensures type safety and consistency between the frontend and backend implementations.
+This package contains shared contracts for WebSocket events, payloads, and other common types used across the KeyBud V2 ecosystem. It ensures type safety and consistency between the
+two repositories.
 
 ## Installation
 
@@ -39,102 +40,7 @@ Handles authentication-related WebSocket events:
 
 - **Events**:
   - `AuthClientToServerEvents` - Client-to-server event types
-  - `ServerToClientEvents` - Server-to-client event types
-
-- **Payloads**: `AuthSubscribePayload`, `AuthSubscribeSuccessPayload`
-
-#### Messages (`ws/messages`)
-
-Handles messaging-related WebSocket events:
-
-- **Event Names**: `MESSAGE_EVENT_NAMES`
-  - `SUBSCRIBE` - Client subscribes to messages
-  - `NEW_MESSAGE` - Server sends new message
-
-- **Events**:
-  - `MessageClientToServerEvents` - Client-to-server event types
-  - `MessageServerToClientEvents` - Server-to-client event types
-
-- **Payloads**: `MessageSubscribePayload`, `NewMessagePayload`
-
-## Development
-
-### Prerequisites
-
-- Node.js >= 14.17
-- pnpm 10.17.0
-
-### Scripts
-
-```sh
-# Run tests (not yet implemented)
-pnpm test
-```
-
-### Project Configuration
-
-- **TypeScript**: Strict mode enabled with modern module resolution
-- **Package Manager**: pnpm with workspace support
-- **Module System**: ES Modules
-
-## Contributing
-
-1. Fork the repository
-2. Create your feature branch
-3. Add your contracts to the appropriate directory under `src/`
-4. Export new contracts from `src/index.ts`
-5. Submit a pull request
-
-## License
-
-MIT © Jom Karlo Verzosa
-
-## Repository
-
-[https://github.com/jomkv/keybud-v2-contracts](https://github.com/jomkv/keybud-v2-contracts)
-
-````# KeyBud V2 Contracts
-
-Shared TypeScript contracts and type definitions for KeyBud V2, providing type-safe communication between frontend and backend applications.
-
-## Overview
-
-This package contains shared contracts for WebSocket events, payloads, and other common types used across the KeyBud V2 ecosystem. It ensures type safety and consistency between the frontend and backend implementations.
-
-## Installation
-
-```sh
-pnpm add @jomkv/keybud-v2-contracts
-````
-
-## Usage
-
-```typescript
-import {
-  AUTH_EVENT_NAMES,
-  MESSAGE_EVENT_NAMES,
-  type AuthClientToServerEvents,
-  type MessageServerToClientEvents,
-  type NewMessagePayload,
-} from "@jomkv/keybud-v2-contracts";
-```
-
-## Structure
-
-### WebSocket Contracts
-
-#### Authentication (`ws/auth`)
-
-Handles authentication-related WebSocket events:
-
-- **Event Names**: `AUTH_EVENT_NAMES`
-  - `SUBSCRIBE` - Client subscribes to auth events
-  - `SUBSCRIBE_SUCCESS` - Server confirms subscription
-  - `COMPLETE` - Client completes login
-
-- **Events**:
-  - `AuthClientToServerEvents` - Client-to-server event types
-  - `ServerToClientEvents` - Server-to-client event types
+  - `AuthServerToClientEvents` - Server-to-client event types
 
 - **Payloads**: `AuthSubscribePayload`, `AuthSubscribeSuccessPayload`
 

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./ws/auth/index";
+export * from "./ws/messages/index";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./ws/auth/index";
+export * from "./ws/messages/index";
+//# 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,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/ws/auth/event-names.d.ts

@@ -0,0 +1,7 @@
+export declare const AUTH_EVENT_NAMES: {
+    readonly SUBSCRIBE: "auth:subscribe";
+    readonly SUBSCRIBE_SUCCESS: "auth:subscribe_success";
+    readonly COMPLETE: "auth:complete";
+};
+export type AuthEventName = (typeof AUTH_EVENT_NAMES)[keyof typeof AUTH_EVENT_NAMES];
+//# sourceMappingURL=event-names.d.ts.map

package/dist/ws/auth/event-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-names.d.ts","sourceRoot":"","sources":["../../../src/ws/auth/event-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,MAAM,MAAM,aAAa,GACvB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/ws/auth/event-names.js

@@ -0,0 +1,6 @@
+export const AUTH_EVENT_NAMES = {
+    SUBSCRIBE: "auth:subscribe",
+    SUBSCRIBE_SUCCESS: "auth:subscribe_success",
+    COMPLETE: "auth:complete", // client completes login
+};
+//# sourceMappingURL=event-names.js.map

package/dist/ws/auth/event-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-names.js","sourceRoot":"","sources":["../../../src/ws/auth/event-names.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS,EAAE,gBAAgB;IAC3B,iBAAiB,EAAE,wBAAwB;IAC3C,QAAQ,EAAE,eAAe,EAAE,yBAAyB;CAC5C,CAAC"}

package/dist/ws/auth/events.d.ts

@@ -0,0 +1,10 @@
+import type { AUTH_EVENT_NAMES } from "./event-names.ts";
+import type { AuthSubscribePayload, AuthSubscribeSuccessPayload } from "./payloads.js";
+export interface AuthClientToServerEvents {
+    [AUTH_EVENT_NAMES.SUBSCRIBE]: AuthSubscribePayload;
+}
+export interface AuthServerToClientEvents {
+    [AUTH_EVENT_NAMES.SUBSCRIBE_SUCCESS]: AuthSubscribeSuccessPayload;
+    [AUTH_EVENT_NAMES.COMPLETE]: {};
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/ws/auth/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/ws/auth/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EACV,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,wBAAwB;IACvC,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;CACpD;AAED,MAAM,WAAW,wBAAwB;IACvC,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,2BAA2B,CAAC;IAClE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;CACjC"}

package/dist/ws/auth/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/ws/auth/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/ws/auth/events.ts"],"names":[],"mappings":""}

package/dist/ws/auth/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./event-names";
+export * from "./events";
+export * from "./payloads";
+//# sourceMappingURL=index.d.ts.map

package/dist/ws/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ws/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/ws/auth/index.js

@@ -0,0 +1,4 @@
+export * from "./event-names";
+export * from "./events";
+export * from "./payloads";
+//# sourceMappingURL=index.js.map

package/dist/ws/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ws/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/{src/ws/auth/payloads.ts → dist/ws/auth/payloads.d.ts}

@@ -1,7 +1,7 @@
-export interface AuthSubscribePayload {
-  sessionId: string;
-}
-
-export interface AuthSubscribeSuccessPayload {
-  sessionId: string;
-}
+export interface AuthSubscribePayload {
+    sessionId: string;
+}
+export interface AuthSubscribeSuccessPayload {
+    sessionId: string;
+}
+//# sourceMappingURL=payloads.d.ts.map

package/dist/ws/auth/payloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloads.d.ts","sourceRoot":"","sources":["../../../src/ws/auth/payloads.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/ws/auth/payloads.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=payloads.js.map

package/dist/ws/auth/payloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloads.js","sourceRoot":"","sources":["../../../src/ws/auth/payloads.ts"],"names":[],"mappings":""}

package/dist/ws/messages/event-names.d.ts

@@ -0,0 +1,6 @@
+export declare const MESSAGE_EVENT_NAMES: {
+    readonly SUBSCRIBE: "message:subscribe";
+    readonly NEW_MESSAGE: "message:new";
+};
+export type MessageEventName = (typeof MESSAGE_EVENT_NAMES)[keyof typeof MESSAGE_EVENT_NAMES];
+//# sourceMappingURL=event-names.d.ts.map

package/dist/ws/messages/event-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-names.d.ts","sourceRoot":"","sources":["../../../src/ws/messages/event-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/ws/messages/event-names.js

@@ -0,0 +1,5 @@
+export const MESSAGE_EVENT_NAMES = {
+    SUBSCRIBE: "message:subscribe",
+    NEW_MESSAGE: "message:new",
+};
+//# sourceMappingURL=event-names.js.map

package/dist/ws/messages/event-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-names.js","sourceRoot":"","sources":["../../../src/ws/messages/event-names.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,mBAAmB;IAC9B,WAAW,EAAE,aAAa;CAClB,CAAC"}

package/{src/ws/messages/events.ts → dist/ws/messages/events.d.ts}

@@ -1,10 +1,9 @@
-import type { MESSAGE_EVENT_NAMES } from "./event-names.ts";
-import type { MessageSubscribePayload, NewMessagePayload } from "./payloads.js";
-
-export interface MessageClientToServerEvents {
-  [MESSAGE_EVENT_NAMES.SUBSCRIBE]: MessageSubscribePayload;
-}
-
-export interface MessageServerToClientEvents {
-  [MESSAGE_EVENT_NAMES.NEW_MESSAGE]: NewMessagePayload;
-}
+import type { MESSAGE_EVENT_NAMES } from "./event-names.ts";
+import type { MessageSubscribePayload, NewMessagePayload } from "./payloads.js";
+export interface MessageClientToServerEvents {
+    [MESSAGE_EVENT_NAMES.SUBSCRIBE]: MessageSubscribePayload;
+}
+export interface MessageServerToClientEvents {
+    [MESSAGE_EVENT_NAMES.NEW_MESSAGE]: NewMessagePayload;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/ws/messages/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/ws/messages/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEhF,MAAM,WAAW,2BAA2B;IAC1C,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,uBAAuB,CAAC;CAC1D;AAED,MAAM,WAAW,2BAA2B;IAC1C,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACtD"}

package/dist/ws/messages/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/ws/messages/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/ws/messages/events.ts"],"names":[],"mappings":""}

package/dist/ws/messages/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./event-names";
+export * from "./events";
+export * from "./payloads";
+//# sourceMappingURL=index.d.ts.map

package/dist/ws/messages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ws/messages/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/ws/messages/index.js

@@ -0,0 +1,4 @@
+export * from "./event-names";
+export * from "./events";
+export * from "./payloads";
+//# sourceMappingURL=index.js.map

package/dist/ws/messages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ws/messages/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/ws/messages/payloads.d.ts

@@ -0,0 +1,12 @@
+export interface NewMessagePayload {
+    id: number;
+    senderId: number;
+    conversationId: number;
+    content: string;
+    createdAt: Date;
+    readAt?: Date;
+}
+export interface MessageSubscribePayload {
+    userId: number;
+}
+//# sourceMappingURL=payloads.d.ts.map

package/dist/ws/messages/payloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloads.d.ts","sourceRoot":"","sources":["../../../src/ws/messages/payloads.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,CAAC,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/ws/messages/payloads.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=payloads.js.map

package/dist/ws/messages/payloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloads.js","sourceRoot":"","sources":["../../../src/ws/messages/payloads.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "@jomkv/keybud-v2-contracts",
-  "version": "1.0.0",
-  "description": "",
-  "keywords": [],
+  "version": "1.0.2",
+  "description": "Shared TypeScript contracts for KeyBud V2",
+  "keywords": [
+    "keybud",
+    "contracts",
+    "typescript",
+    "websocket"
+  ],
   "homepage": "https://github.com/jomkv/keybud-v2-contracts#readme",
   "bugs": {
     "url": "https://github.com/jomkv/keybud-v2-contracts/issues"
@@ -14,14 +19,24 @@
   "license": "MIT",
   "author": "Jom Karlo Verzosa",
   "type": "module",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
   },
+  "files": [
+    "dist"
+  ],
   "devDependencies": {
     "@types/node": "^25.0.8",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
   },
-  "packageManager": "pnpm@10.17.0"
-}
+  "scripts": {
+    "build": "tsc",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}

package/src/index.ts

@@ -1,2 +0,0 @@
-export * from "./ws/auth/index.ts";
-export * from "./ws/messages/index.ts";

package/src/ws/auth/event-names.ts

@@ -1,8 +0,0 @@
-export const AUTH_EVENT_NAMES = {
-  SUBSCRIBE: "auth:subscribe",
-  SUBSCRIBE_SUCCESS: "auth:subscribe_success",
-  COMPLETE: "auth:complete", // client completes login
-} as const;
-
-export type AuthEventName =
-  (typeof AUTH_EVENT_NAMES)[keyof typeof AUTH_EVENT_NAMES];

package/src/ws/auth/events.ts

@@ -1,14 +0,0 @@
-import type { AUTH_EVENT_NAMES } from "./event-names.ts";
-import type {
-  AuthSubscribePayload,
-  AuthSubscribeSuccessPayload,
-} from "./payloads.js";
-
-export interface AuthClientToServerEvents {
-  [AUTH_EVENT_NAMES.SUBSCRIBE]: AuthSubscribePayload;
-}
-
-export interface ServerToClientEvents {
-  [AUTH_EVENT_NAMES.SUBSCRIBE_SUCCESS]: AuthSubscribeSuccessPayload;
-  [AUTH_EVENT_NAMES.COMPLETE]: {};
-}

package/src/ws/auth/index.ts

@@ -1,3 +0,0 @@
-export * from "./event-names.ts";
-export * from "./events.ts";
-export * from "./payloads.ts";

package/src/ws/messages/event-names.ts

@@ -1,7 +0,0 @@
-export const MESSAGE_EVENT_NAMES = {
-  SUBSCRIBE: "message:subscribe",
-  NEW_MESSAGE: "message:new",
-} as const;
-
-export type MessageEventName =
-  (typeof MESSAGE_EVENT_NAMES)[keyof typeof MESSAGE_EVENT_NAMES];

package/src/ws/messages/index.ts

@@ -1,3 +0,0 @@
-export * from "./event-names.ts";
-export * from "./events.ts";
-export * from "./payloads.ts";

package/src/ws/messages/payloads.ts

@@ -1,12 +0,0 @@
-export interface NewMessagePayload {
-  id: number;
-  senderId: number;
-  conversationId: number;
-  content: string;
-  createdAt: Date;
-  readAt?: Date;
-}
-
-export interface MessageSubscribePayload {
-  userId: number;
-}

package/tsconfig.json

@@ -1,48 +0,0 @@
-{
-  // Visit https://aka.ms/tsconfig to read more about this file
-  "compilerOptions": {
-    // File Layout
-    // "rootDir": "./src",
-    // "outDir": "./dist",
-
-    // Environment Settings
-    // See also https://aka.ms/tsconfig/module
-    "module": "nodenext",
-    "target": "esnext",
-    "types": [],
-    // For nodejs:
-    // "lib": ["esnext"],
-    // "types": ["node"],
-    // and npm install -D @types/node
-
-    // Other Outputs
-    "sourceMap": true,
-    "declaration": true,
-    "declarationMap": true,
-
-    // Stricter Typechecking Options
-    "noUncheckedIndexedAccess": true,
-    "exactOptionalPropertyTypes": true,
-
-    // Style Options
-    // "noImplicitReturns": true,
-    // "noImplicitOverride": true,
-    // "noUnusedLocals": true,
-    // "noUnusedParameters": true,
-    // "noFallthroughCasesInSwitch": true,
-    // "noPropertyAccessFromIndexSignature": true,
-
-    // Recommended Options
-    "strict": true,
-    "jsx": "react-jsx",
-    "verbatimModuleSyntax": true,
-    "isolatedModules": true,
-    "noUncheckedSideEffectImports": true,
-    "moduleDetection": "force",
-    "skipLibCheck": true,
-
-    // Custom
-    "allowImportingTsExtensions": true,
-    "noEmit": true
-  }
-}