saajhedaari-types 1.0.0

package/README.md

@@ -0,0 +1,106 @@
+# saajhedaari-types
+
+Shared TypeScript types for **Saajhedaari** - a collaborative expense splitting and group management application.
+
+> ⚠️ **Private Package**: This package builds on install and requires TypeScript in consumer environments.
+
+## Installation
+
+From Git:
+```bash
+npm install git+https://github.com/GeekyMayank19/saajhedaari-types.git
+```
+
+Or add to `package.json`:
+```json
+{
+  "dependencies": {
+    "saajhedaari-types": "github:GeekyMayank19/saajhedaari-types"
+  }
+}
+```
+
+## Requirements
+
+- **Node.js** >= 18.0.0
+- **TypeScript** >= 5.3.0 (installed as devDependency)
+
+## How It Works
+
+1. Package contains only TypeScript source files (`src/`)
+2. On `npm install`, the `prepare` script runs automatically
+3. TypeScript compiles `src/` → `dist/`
+4. Runtime uses `dist/index.js`, types from `dist/index.d.ts`
+
+## Usage
+
+```typescript
+import { 
+  User, 
+  Group, 
+  Expense, 
+  LoginReq, 
+  LoginRes,
+  Role,
+  SplitType 
+} from 'saajhedaari-types';
+
+// Example
+const loginPayload: LoginReq = {
+  email: 'user@example.com',
+  password: 'password123'
+};
+```
+
+## Available Types
+
+### Authentication
+- `LoginReq`, `LoginRes`, `RegisterReq`, `RegisterRes`, `JwtPayload`
+
+### User
+- `User`, `CreateUserReq`, `UpdateUserReq`
+
+### Group
+- `Group`, `GroupMember`, `GroupWithMembers`, `GroupWithOwner`
+- `CreateGroupReq`, `UpdateGroupReq`, `AddMemberReq`
+
+### Expense
+- `Expense`, `ExpenseShare`, `ExpenseWithShares`
+- `CreateExpenseReq`, `UpdateExpenseReq`
+- `ShareInputUnequal`, `ShareInputPercentage`, `ShareInputByUnits`
+- `ExpenseHistory`, `ExpenseSnapshot`
+
+### Enums
+- `Role` (`ADMIN`, `MEMBER`)
+- `SplitType` (`EQUAL`, `UNEQUAL`, `PERCENTAGE`, `SHARES`)
+- `ExpenseAction` (`CREATED`, `UPDATED`, `DELETED`)
+
+## Development
+
+```bash
+npm install    # Installs deps + runs prepare (builds)
+npm run build  # Manual rebuild
+```
+
+## Project Structure
+
+```
+src/
+├── index.ts          # Main entry - exports all types
+├── auth.types.ts     # Authentication types
+├── user.types.ts     # User types  
+├── group.types.ts    # Group types
+├── expense.types.ts  # Expense types
+└── enums.ts          # Shared enums
+```
+
+## Migration to Public Package
+
+If this package becomes public later:
+1. Change `prepare` → `prepublishOnly`
+2. Remove `dist/` from `.npmignore`
+3. Pre-build and publish `dist/`
+
+## License
+
+MIT

package/dist/auth.types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Login request body
+ */
+export interface LoginReq {
+    email: string;
+    password: string;
+}
+/**
+ * Login response
+ */
+export interface LoginRes {
+    accessToken: string;
+}
+/**
+ * Registration request body
+ */
+export interface RegisterReq {
+    name: string;
+    email: string;
+    password: string;
+}
+/**
+ * Registration response
+ */
+export interface RegisterRes {
+    accessToken: string;
+}
+/**
+ * JWT token payload structure
+ */
+export interface JwtPayload {
+    sub: string;
+    email: string;
+}
+//# sourceMappingURL=auth.types.d.ts.map

package/dist/auth.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.types.d.ts","sourceRoot":"","sources":["../src/auth.types.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACjB"}

package/dist/auth.types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ============================================================
+// Auth Types
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=auth.types.js.map

package/dist/auth.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.types.js","sourceRoot":"","sources":["../src/auth.types.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,aAAa;AACb,+DAA+D"}

package/dist/enums.d.ts

@@ -0,0 +1,25 @@
+/**
+ * User role within a group
+ */
+export declare enum Role {
+    ADMIN = "ADMIN",
+    MEMBER = "MEMBER"
+}
+/**
+ * How an expense is split among group members
+ */
+export declare enum SplitType {
+    EQUAL = "EQUAL",
+    UNEQUAL = "UNEQUAL",
+    PERCENTAGE = "PERCENTAGE",
+    SHARES = "SHARES"
+}
+/**
+ * Expense audit actions
+ */
+export declare enum ExpenseAction {
+    CREATED = "CREATED",
+    UPDATED = "UPDATED",
+    DELETED = "DELETED"
+}
+//# sourceMappingURL=enums.d.ts.map

package/dist/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,oBAAY,IAAI;IACZ,KAAK,UAAU;IACf,MAAM,WAAW;CACpB;AAED;;GAEG;AACH,oBAAY,SAAS;IACjB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,MAAM,WAAW;CACpB;AAED;;GAEG;AACH,oBAAY,aAAa;IACrB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;CACtB"}

package/dist/enums.js

@@ -0,0 +1,34 @@
+"use strict";
+// ============================================================
+// Enums - Extracted from Prisma schema
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpenseAction = exports.SplitType = exports.Role = void 0;
+/**
+ * User role within a group
+ */
+var Role;
+(function (Role) {
+    Role["ADMIN"] = "ADMIN";
+    Role["MEMBER"] = "MEMBER";
+})(Role || (exports.Role = Role = {}));
+/**
+ * How an expense is split among group members
+ */
+var SplitType;
+(function (SplitType) {
+    SplitType["EQUAL"] = "EQUAL";
+    SplitType["UNEQUAL"] = "UNEQUAL";
+    SplitType["PERCENTAGE"] = "PERCENTAGE";
+    SplitType["SHARES"] = "SHARES";
+})(SplitType || (exports.SplitType = SplitType = {}));
+/**
+ * Expense audit actions
+ */
+var ExpenseAction;
+(function (ExpenseAction) {
+    ExpenseAction["CREATED"] = "CREATED";
+    ExpenseAction["UPDATED"] = "UPDATED";
+    ExpenseAction["DELETED"] = "DELETED";
+})(ExpenseAction || (exports.ExpenseAction = ExpenseAction = {}));
+//# sourceMappingURL=enums.js.map

package/dist/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,uCAAuC;AACvC,+DAA+D;;;AAE/D;;GAEG;AACH,IAAY,IAGX;AAHD,WAAY,IAAI;IACZ,uBAAe,CAAA;IACf,yBAAiB,CAAA;AACrB,CAAC,EAHW,IAAI,oBAAJ,IAAI,QAGf;AAED;;GAEG;AACH,IAAY,SAKX;AALD,WAAY,SAAS;IACjB,4BAAe,CAAA;IACf,gCAAmB,CAAA;IACnB,sCAAyB,CAAA;IACzB,8BAAiB,CAAA;AACrB,CAAC,EALW,SAAS,yBAAT,SAAS,QAKpB;AAED;;GAEG;AACH,IAAY,aAIX;AAJD,WAAY,aAAa;IACrB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;AACvB,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB"}

package/dist/expense.types.d.ts

@@ -0,0 +1,112 @@
+import { SplitType, ExpenseAction } from './enums';
+/**
+ * Individual share in an expense
+ */
+export interface ExpenseShare {
+    id: string;
+    expenseId: string;
+    userId: string;
+    owedAmount: string;
+    userName?: string;
+}
+/**
+ * Expense entity
+ */
+export interface Expense {
+    id: string;
+    title: string;
+    amount: string;
+    paidById: string;
+    groupId: string;
+    splitType: SplitType;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Expense with share breakdown
+ */
+export interface ExpenseWithShares extends Expense {
+    shares: ExpenseShare[];
+}
+/**
+ * Share input for UNEQUAL split - fixed amounts
+ */
+export interface ShareInputUnequal {
+    userId: string;
+    owedAmount: number;
+}
+/**
+ * Share input for PERCENTAGE split
+ */
+export interface ShareInputPercentage {
+    userId: string;
+    percent: number;
+}
+/**
+ * Share input for SHARES split - relative units
+ */
+export interface ShareInputByUnits {
+    userId: string;
+    shares: number;
+}
+/**
+ * Union type for all share input variants
+ */
+export type ShareInput = ShareInputUnequal | ShareInputPercentage | ShareInputByUnits;
+/**
+ * Create expense request
+ */
+export interface CreateExpenseReq {
+    title: string;
+    amount: number;
+    groupId: string;
+    splitType: SplitType;
+    shares?: ShareInput[];
+}
+/**
+ * Update expense request
+ */
+export interface UpdateExpenseReq {
+    title?: string;
+    amount?: number;
+    splitType?: SplitType;
+    shares?: ShareInput[];
+}
+/**
+ * Expense snapshot for audit/rollback
+ */
+export interface ExpenseSnapshot {
+    id: string;
+    title: string;
+    amount: string;
+    splitType: SplitType;
+    groupId: string;
+    paidById: string;
+    createdAt: string;
+    updatedAt: string;
+    shares: {
+        userId: string;
+        owedAmount: string;
+    }[];
+}
+/**
+ * Expense audit history entry
+ */
+export interface ExpenseHistory {
+    id: string;
+    expenseId: string | null;
+    action: ExpenseAction;
+    changedById: string;
+    createdAt: string;
+    snapshot?: ExpenseSnapshot;
+}
+/**
+ * Individual field change in expense history
+ */
+export interface ExpenseChange {
+    id: string;
+    fieldName: string;
+    oldValue: string | null;
+    newValue: string | null;
+}
+//# sourceMappingURL=expense.types.d.ts.map

package/dist/expense.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expense.types.d.ts","sourceRoot":"","sources":["../src/expense.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAMnD;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,OAAO;IAC9C,MAAM,EAAE,YAAY,EAAE,CAAC;CAC1B;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAChB,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACtB,EAAE,CAAC;CACP;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/expense.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=expense.types.js.map

package/dist/expense.types.js.map

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

package/dist/group.types.d.ts

@@ -0,0 +1,60 @@
+import { Role } from './enums';
+/**
+ * Group entity
+ */
+export interface Group {
+    id: string;
+    name: string;
+    description: string | null;
+    ownerId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Group member with role and join date
+ */
+export interface GroupMember {
+    id: string;
+    name: string;
+    email: string;
+    role: Role;
+    joinedAt: string;
+}
+/**
+ * Group with members list
+ */
+export interface GroupWithMembers extends Group {
+    members: GroupMember[];
+}
+/**
+ * Group with owner details
+ */
+export interface GroupWithOwner extends Group {
+    owner: {
+        id: string;
+        email: string;
+        name: string;
+    };
+}
+/**
+ * Create group request
+ */
+export interface CreateGroupReq {
+    name: string;
+    description?: string;
+}
+/**
+ * Update group request
+ */
+export interface UpdateGroupReq {
+    name?: string;
+    description?: string;
+}
+/**
+ * Add member to group request
+ */
+export interface AddMemberReq {
+    userId: string;
+    role: Role;
+}
+//# sourceMappingURL=group.types.d.ts.map

package/dist/group.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.types.d.ts","sourceRoot":"","sources":["../src/group.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAM/B;;GAEG;AACH,MAAM,WAAW,KAAK;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,KAAK;IAC3C,OAAO,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK;IACzC,KAAK,EAAE;QACH,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;CACd"}

package/dist/group.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=group.types.js.map

package/dist/group.types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './enums';
+export * from './auth.types';
+export * from './user.types';
+export * from './group.types';
+export * from './expense.types';
+//# 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":"AAMA,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,cAAc,cAAc,CAAC;AAG7B,cAAc,eAAe,CAAC;AAG9B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+"use strict";
+// ============================================================
+// @saajhedaari/shared-types
+// Shared TypeScript types for frontend and backend
+// ============================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Enums
+__exportStar(require("./enums"), exports);
+// Auth
+__exportStar(require("./auth.types"), exports);
+// User
+__exportStar(require("./user.types"), exports);
+// Group
+__exportStar(require("./group.types"), exports);
+// Expense
+__exportStar(require("./expense.types"), exports);
+//# 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,+DAA+D;AAC/D,4BAA4B;AAC5B,mDAAmD;AACnD,+DAA+D;;;;;;;;;;;;;;;;AAE/D,QAAQ;AACR,0CAAwB;AAExB,OAAO;AACP,+CAA6B;AAE7B,OAAO;AACP,+CAA6B;AAE7B,QAAQ;AACR,gDAA8B;AAE9B,UAAU;AACV,kDAAgC"}

package/dist/user.types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * User entity (without password - safe for frontend)
+ */
+export interface User {
+    id: string;
+    email: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Create user request
+ */
+export interface CreateUserReq {
+    email: string;
+    password: string;
+    name: string;
+}
+/**
+ * Update user request (all fields optional)
+ */
+export interface UpdateUserReq {
+    email?: string;
+    name?: string;
+}
+//# sourceMappingURL=user.types.d.ts.map

package/dist/user.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.types.d.ts","sourceRoot":"","sources":["../src/user.types.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,IAAI;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/user.types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ============================================================
+// User Types
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=user.types.js.map

package/dist/user.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.types.js","sourceRoot":"","sources":["../src/user.types.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,aAAa;AACb,+DAA+D"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "saajhedaari-types",
+  "version": "1.0.0",
+  "description": "Shared TypeScript types for Saajhedaari - expense splitting and group management",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "npm run build",
+    "clean": "rmdir /s /q dist 2>nul || true",
+    "prepublishOnly": "npm run build",
+    "publish-pack": "npm run build && npm publish"
+  },
+  "keywords": [
+    "types",
+    "typescript",
+    "saajhedaari",
+    "expense",
+    "splitting",
+    "shared-types"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GeekyMayank19/saajhedaari-types.git"
+  },
+  "author": "GeekyMayank19",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/GeekyMayank19/saajhedaari-types/issues"
+  },
+  "homepage": "https://github.com/GeekyMayank19/saajhedaari-types#readme",
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/auth.types.ts

@@ -0,0 +1,42 @@
+// ============================================================
+// Auth Types
+// ============================================================
+
+/**
+ * Login request body
+ */
+export interface LoginReq {
+    email: string;
+    password: string;
+}
+
+/**
+ * Login response
+ */
+export interface LoginRes {
+    accessToken: string;
+}
+
+/**
+ * Registration request body
+ */
+export interface RegisterReq {
+    name: string;
+    email: string;
+    password: string;
+}
+
+/**
+ * Registration response
+ */
+export interface RegisterRes {
+    accessToken: string;
+}
+
+/**
+ * JWT token payload structure
+ */
+export interface JwtPayload {
+    sub: string;
+    email: string;
+}

package/src/enums.ts

@@ -0,0 +1,30 @@
+// ============================================================
+// Enums - Extracted from Prisma schema
+// ============================================================
+
+/**
+ * User role within a group
+ */
+export enum Role {
+    ADMIN = 'ADMIN',
+    MEMBER = 'MEMBER',
+}
+
+/**
+ * How an expense is split among group members
+ */
+export enum SplitType {
+    EQUAL = 'EQUAL',
+    UNEQUAL = 'UNEQUAL',
+    PERCENTAGE = 'PERCENTAGE',
+    SHARES = 'SHARES',
+}
+
+/**
+ * Expense audit actions
+ */
+export enum ExpenseAction {
+    CREATED = 'CREATED',
+    UPDATED = 'UPDATED',
+    DELETED = 'DELETED',
+}

package/src/expense.types.ts

@@ -0,0 +1,138 @@
+import { SplitType, ExpenseAction } from './enums';
+
+// ============================================================
+// Expense Types
+// ============================================================
+
+/**
+ * Individual share in an expense
+ */
+export interface ExpenseShare {
+    id: string;
+    expenseId: string;
+    userId: string;
+    owedAmount: string; // String for precision (money)
+    userName?: string;
+}
+
+/**
+ * Expense entity
+ */
+export interface Expense {
+    id: string;
+    title: string;
+    amount: string; // String for precision (money)
+    paidById: string;
+    groupId: string;
+    splitType: SplitType;
+    createdAt: string;
+    updatedAt: string;
+}
+
+/**
+ * Expense with share breakdown
+ */
+export interface ExpenseWithShares extends Expense {
+    shares: ExpenseShare[];
+}
+
+// ============================================================
+// Share Input Types (for creating/updating expenses)
+// ============================================================
+
+/**
+ * Share input for UNEQUAL split - fixed amounts
+ */
+export interface ShareInputUnequal {
+    userId: string;
+    owedAmount: number;
+}
+
+/**
+ * Share input for PERCENTAGE split
+ */
+export interface ShareInputPercentage {
+    userId: string;
+    percent: number;
+}
+
+/**
+ * Share input for SHARES split - relative units
+ */
+export interface ShareInputByUnits {
+    userId: string;
+    shares: number;
+}
+
+/**
+ * Union type for all share input variants
+ */
+export type ShareInput =
+    | ShareInputUnequal
+    | ShareInputPercentage
+    | ShareInputByUnits;
+
+/**
+ * Create expense request
+ */
+export interface CreateExpenseReq {
+    title: string;
+    amount: number;
+    groupId: string;
+    splitType: SplitType;
+    shares?: ShareInput[];
+}
+
+/**
+ * Update expense request
+ */
+export interface UpdateExpenseReq {
+    title?: string;
+    amount?: number;
+    splitType?: SplitType;
+    shares?: ShareInput[];
+}
+
+// ============================================================
+// Expense History Types
+// ============================================================
+
+/**
+ * Expense snapshot for audit/rollback
+ */
+export interface ExpenseSnapshot {
+    id: string;
+    title: string;
+    amount: string;
+    splitType: SplitType;
+    groupId: string;
+    paidById: string;
+    createdAt: string;
+    updatedAt: string;
+    shares: {
+        userId: string;
+        owedAmount: string;
+    }[];
+}
+
+/**
+ * Expense audit history entry
+ */
+export interface ExpenseHistory {
+    id: string;
+    expenseId: string | null;
+    action: ExpenseAction;
+    changedById: string;
+    createdAt: string;
+    snapshot?: ExpenseSnapshot;
+}
+
+/**
+ * Individual field change in expense history
+ */
+export interface ExpenseChange {
+    id: string;
+    fieldName: string;
+    oldValue: string | null;
+    newValue: string | null;
+}

package/src/group.types.ts

@@ -0,0 +1,70 @@
+import { Role } from './enums';
+
+// ============================================================
+// Group Types
+// ============================================================
+
+/**
+ * Group entity
+ */
+export interface Group {
+    id: string;
+    name: string;
+    description: string | null;
+    ownerId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+
+/**
+ * Group member with role and join date
+ */
+export interface GroupMember {
+    id: string;
+    name: string;
+    email: string;
+    role: Role;
+    joinedAt: string;
+}
+
+/**
+ * Group with members list
+ */
+export interface GroupWithMembers extends Group {
+    members: GroupMember[];
+}
+
+/**
+ * Group with owner details
+ */
+export interface GroupWithOwner extends Group {
+    owner: {
+        id: string;
+        email: string;
+        name: string;
+    };
+}
+
+/**
+ * Create group request
+ */
+export interface CreateGroupReq {
+    name: string;
+    description?: string;
+}
+
+/**
+ * Update group request
+ */
+export interface UpdateGroupReq {
+    name?: string;
+    description?: string;
+}
+
+/**
+ * Add member to group request
+ */
+export interface AddMemberReq {
+    userId: string;
+    role: Role;
+}

package/src/index.ts

@@ -0,0 +1,19 @@
+// ============================================================
+// @saajhedaari/shared-types
+// Shared TypeScript types for frontend and backend
+// ============================================================
+
+// Enums
+export * from './enums';
+
+// Auth
+export * from './auth.types';
+
+// User
+export * from './user.types';
+
+// Group
+export * from './group.types';
+
+// Expense
+export * from './expense.types';

package/src/user.types.ts

@@ -0,0 +1,31 @@
+// ============================================================
+// User Types
+// ============================================================
+
+/**
+ * User entity (without password - safe for frontend)
+ */
+export interface User {
+    id: string;
+    email: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+}
+
+/**
+ * Create user request
+ */
+export interface CreateUserReq {
+    email: string;
+    password: string;
+    name: string;
+}
+
+/**
+ * Update user request (all fields optional)
+ */
+export interface UpdateUserReq {
+    email?: string;
+    name?: string;
+}

package/tsconfig.json

@@ -0,0 +1,32 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "commonjs",
+        "lib": [
+            "ES2020"
+        ],
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true,
+        "moduleResolution": "node",
+        "resolveJsonModule": true,
+        "noEmitOnError": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noImplicitReturns": true,
+        "noFallthroughCasesInSwitch": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}