@guinetik/primitives-ts 0.5.1 → 0.6.0

package/README.md

@@ -72,9 +72,77 @@ const metrics: SystemMetrics = {
 # Build the package
 npm run build
 
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Generate coverage report
+npm run test:cov
+
 # The build output will be in the dist/ folder
 ```
 
+## Testing
+
+This package includes unit tests using Jest with TypeScript support.
+
+### Test Coverage
+
+Tests cover:
+- **Type Guards** - Runtime validation for chat types, models, and request objects
+- **Enum Validation** - ClaudeModel enum consistency and format checks
+- **Constants** - Model tier values and chat role validation
+- **Edge Cases** - Null/undefined handling, invalid types, and boundary conditions
+
+### Running Tests
+
+```bash
+# Run all tests once
+npm test
+
+# Watch mode for test-driven development
+npm run test:watch
+
+# Generate HTML coverage report (outputs to coverage/ folder)
+npm run test:cov
+```
+
+### Type Guards
+
+The package exports runtime type guards for validating data structures:
+
+```typescript
+import {
+  isChatMessage,
+  isChatSession,
+  isModel,
+  isSendMessageRequest
+} from '@guinetik/primitives-ts';
+
+// Validate incoming data
+if (isChatMessage(data)) {
+  // TypeScript knows data is ChatMessage here
+  console.log(data.content);
+}
+
+// Validate API requests
+if (isSendMessageRequest(req.body)) {
+  // Safe to use req.body as SendMessageRequest
+  const { message, model } = req.body;
+}
+```
+
+Available type guards:
+- `isChatRole(value)` - Validates 'user' | 'assistant'
+- `isChatMessage(obj)` - Validates ChatMessage interface
+- `isChatSession(obj)` - Validates ChatSession interface
+- `isModel(obj)` - Validates Model interface
+- `isClaudeModel(value)` - Validates ClaudeModel enum values
+- `isSendMessageRequest(obj)` - Validates SendMessageRequest interface
+- `isCreateSessionRequest(obj)` - Validates CreateSessionRequest interface
+
 ## Publishing Workflow
 
 ### ⚠️ IMPORTANT: Never Link Locally

package/dist/chat.types.spec.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Chat Types Tests
+ * Validation tests for enums and constants
+ */
+export {};
+//# sourceMappingURL=chat.types.spec.d.ts.map

package/dist/chat.types.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.types.spec.d.ts","sourceRoot":"","sources":["../src/chat.types.spec.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/chat.types.spec.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Chat Types Tests
+ * Validation tests for enums and constants
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const chat_types_1 = require("./chat.types");
+describe('Chat Types', () => {
+    describe('ClaudeModel Enum', () => {
+        it('should have valid model IDs starting with "claude-"', () => {
+            const allModels = Object.values(chat_types_1.ClaudeModel);
+            allModels.forEach((modelId) => {
+                expect(modelId).toMatch(/^claude-/);
+            });
+        });
+        it('should have exactly 4 defined models', () => {
+            const modelCount = Object.keys(chat_types_1.ClaudeModel).length;
+            expect(modelCount).toBe(4);
+        });
+        it('should have HAIKU_3_5 with correct ID', () => {
+            expect(chat_types_1.ClaudeModel.HAIKU_3_5).toBe('claude-3-5-haiku-20241022');
+        });
+        it('should have SONNET_3_5 with correct ID', () => {
+            expect(chat_types_1.ClaudeModel.SONNET_3_5).toBe('claude-3-5-sonnet-20241022');
+        });
+        it('should have SONNET_3_7 with correct ID', () => {
+            expect(chat_types_1.ClaudeModel.SONNET_3_7).toBe('claude-3-5-sonnet-20250219');
+        });
+        it('should have OPUS_3 with correct ID', () => {
+            expect(chat_types_1.ClaudeModel.OPUS_3).toBe('claude-3-opus-20240229');
+        });
+        it('should not have duplicate model IDs', () => {
+            const modelIds = Object.values(chat_types_1.ClaudeModel);
+            const uniqueIds = new Set(modelIds);
+            expect(modelIds.length).toBe(uniqueIds.size);
+        });
+        it('should have model IDs with valid date format', () => {
+            const allModels = Object.values(chat_types_1.ClaudeModel);
+            const datePattern = /\d{8}$/; // YYYYMMDD at the end
+            allModels.forEach((modelId) => {
+                expect(modelId).toMatch(datePattern);
+            });
+        });
+        it('should be accessible by enum key', () => {
+            expect(chat_types_1.ClaudeModel['HAIKU_3_5']).toBeDefined();
+            expect(chat_types_1.ClaudeModel['SONNET_3_5']).toBeDefined();
+            expect(chat_types_1.ClaudeModel['SONNET_3_7']).toBeDefined();
+            expect(chat_types_1.ClaudeModel['OPUS_3']).toBeDefined();
+        });
+        it('should support iteration over enum values', () => {
+            const models = [];
+            for (const model of Object.values(chat_types_1.ClaudeModel)) {
+                models.push(model);
+            }
+            expect(models).toHaveLength(4);
+            expect(models).toContain('claude-3-5-haiku-20241022');
+            expect(models).toContain('claude-3-5-sonnet-20241022');
+            expect(models).toContain('claude-3-5-sonnet-20250219');
+            expect(models).toContain('claude-3-opus-20240229');
+        });
+    });
+    describe('Model Tier Values', () => {
+        const validTiers = ['fast', 'balanced', 'powerful', 'expert'];
+        it('should recognize all valid tier values', () => {
+            validTiers.forEach((tier) => {
+                expect(['fast', 'balanced', 'powerful', 'expert']).toContain(tier);
+            });
+        });
+        it('should have exactly 4 tier options', () => {
+            expect(validTiers).toHaveLength(4);
+        });
+    });
+    describe('ChatRole Type', () => {
+        const validRoles = ['user', 'assistant'];
+        it('should have exactly 2 valid roles', () => {
+            expect(validRoles).toHaveLength(2);
+        });
+        it('should include "user" role', () => {
+            expect(validRoles).toContain('user');
+        });
+        it('should include "assistant" role', () => {
+            expect(validRoles).toContain('assistant');
+        });
+    });
+});

package/dist/file.types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * File upload and management types
+ *
+ * Shared types for file upload, storage, and management across the application.
+ *
+ * @module file.types
+ */
+/**
+ * Metadata for an uploaded file
+ *
+ * Represents a file stored in the system with all its metadata.
+ * Used by both API endpoints and frontend components.
+ */
+export interface FileMetadata {
+    /**
+     * Optional unique identifier for the file
+     */
+    id?: string;
+    /**
+     * Name of the file including extension
+     * @example "example.pdf"
+     */
+    filename: string;
+    /**
+     * Size of the file in bytes
+     */
+    size: number;
+    /**
+     * MIME type of the file
+     * @example "image/png", "application/pdf", "video/mp4"
+     */
+    mimeType: string;
+    /**
+     * ISO 8601 timestamp of when the file was uploaded
+     * @example "2024-01-15T10:30:00.000Z"
+     */
+    uploadedAt: string;
+    /**
+     * Public URL where the file can be accessed
+     * @example "https://example.com/uploads/example.pdf"
+     */
+    url: string;
+}
+/**
+ * Request body for renaming a file
+ */
+export interface RenameFileRequest {
+    /**
+     * New filename (including extension)
+     */
+    newFilename: string;
+}
+/**
+ * Response from file upload operation
+ */
+export interface FileUploadResponse {
+    /**
+     * Array of uploaded file metadata
+     */
+    files: FileMetadata[];
+    /**
+     * Number of files successfully uploaded
+     */
+    count: number;
+}
+/**
+ * File upload status tracking (frontend only)
+ *
+ * Used to track the progress of individual file uploads in the UI.
+ */
+export interface FileUploadProgress {
+    /**
+     * Unique identifier for this upload
+     */
+    id: string;
+    /**
+     * The file being uploaded
+     */
+    file: File;
+    /**
+     * Upload progress percentage (0-100)
+     */
+    progress: number;
+    /**
+     * Current status of the upload
+     */
+    status: 'uploading' | 'success' | 'error';
+    /**
+     * Error message if status is 'error'
+     */
+    error?: string;
+}
+//# sourceMappingURL=file.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.types.d.ts","sourceRoot":"","sources":["../src/file.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,KAAK,EAAE,YAAY,EAAE,CAAC;IAEtB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IAEX;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IAE1C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/file.types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * File upload and management types
+ *
+ * Shared types for file upload, storage, and management across the application.
+ *
+ * @module file.types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -16,7 +16,9 @@ export * from './totp.types';
 export * from './deployment-history.types';
 export * from './github.types';
 export * from './chat.types';
+export * from './type-guards';
 export * from './agent.types';
+export * from './file.types';
 export type { Security, SecurityChallengeOptions, SecurityChallengeResult } from './security.interface';
 export { SecurityLevel } from './security.interface';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,cAAc,CAAC;AAG7B,cAAc,4BAA4B,CAAC;AAG3C,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC;AAG7B,cAAc,eAAe,CAAC;AAG9B,YAAY,EAAE,QAAQ,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,cAAc,CAAC;AAG7B,cAAc,4BAA4B,CAAC;AAG3C,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC;AAG7B,cAAc,eAAe,CAAC;AAG9B,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAG7B,YAAY,EAAE,QAAQ,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -42,7 +42,11 @@ __exportStar(require("./deployment-history.types"), exports);
 __exportStar(require("./github.types"), exports);
 // Chat system types
 __exportStar(require("./chat.types"), exports);
+// Type guards for runtime validation
+__exportStar(require("./type-guards"), exports);
 // Agent monitoring types
 __exportStar(require("./agent.types"), exports);
+// File upload and management types
+__exportStar(require("./file.types"), exports);
 var security_interface_1 = require("./security.interface");
 Object.defineProperty(exports, "SecurityLevel", { enumerable: true, get: function () { return security_interface_1.SecurityLevel; } });

package/dist/system.types.d.ts

@@ -58,6 +58,35 @@ export type ContainerStatus = 'running' | 'stopped' | 'restarting' | 'error';
  * Container health status types
  */
 export type ContainerHealth = 'healthy' | 'unhealthy' | 'starting' | 'none';
+/**
+ * Agent working status types
+ */
+export type AgentWorkingStatus = 'idle' | 'working' | 'reviewing' | 'deploying';
+/**
+ * Agent type definitions
+ */
+export type AgentType = 'dev' | 'tl' | 'designer' | 'infosec';
+/**
+ * Agent information for containers
+ */
+export interface AgentContainerInfo {
+    /** Agent type (dev, tl, designer, infosec) */
+    type: AgentType;
+    /** Agent display name (Daniel, Mr. Smith, Monica, Elliot) */
+    name: string;
+    /** Claude model being used */
+    model: string;
+    /** Current working status */
+    workingStatus: AgentWorkingStatus;
+    /** Current task ID if working */
+    currentTaskId?: string;
+    /** Current task description if working */
+    currentTaskDescription?: string;
+    /** Last activity timestamp */
+    lastActivity?: Date;
+    /** Current git branch if on feature branch */
+    currentBranch?: string;
+}
 /**
  * Docker container information
  */
@@ -82,6 +111,8 @@ export interface Container {
     image: string;
     /** Container health status */
     health: ContainerHealth;
+    /** Agent information (only present for agent containers) */
+    agentInfo?: AgentContainerInfo;
 }
 /**
  * Log level types

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

@@ -1 +1 @@
-{"version":3,"file":"system.types.d.ts","sourceRoot":"","sources":["../src/system.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IAEd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IAEd,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IAEb,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IAEd,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,GAAG,EAAE,OAAO,CAAC;IAEb,yBAAyB;IACzB,MAAM,EAAE,UAAU,CAAC;IAEnB,uBAAuB;IACvB,IAAI,EAAE,QAAQ,CAAC;IAEf,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IAEf,4CAA4C;IAC5C,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IAEX,uBAAuB;IACvB,MAAM,EAAE,eAAe,CAAC;IAExB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IAEZ,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IAEf,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IAErB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IAEd,8BAA8B;IAC9B,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,oBAAoB;IACpB,SAAS,EAAE,IAAI,CAAC;IAEhB,gBAAgB;IAChB,KAAK,EAAE,QAAQ,CAAC;IAEhB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAEhB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC;IAEtB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAElB,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAE1B,yBAAyB;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,cAAc,EAAE,IAAI,CAAC;IAErB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IAEjB,wBAAwB;IACxB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,WAAW,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IAEf,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IAEjB,0BAA0B;IAC1B,UAAU,EAAE,IAAI,CAAC;IAEjB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAEhB,qBAAqB;IACrB,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;CAClC"}
+{"version":3,"file":"system.types.d.ts","sourceRoot":"","sources":["../src/system.types.ts"],"names":[],"mappings":"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"}

package/dist/type-guards.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Type Guards
+ * Runtime type checking for primitives
+ */
+import { ChatMessage, ChatSession, ChatRole, Model, ClaudeModel, SendMessageRequest, CreateSessionRequest } from './chat.types';
+/**
+ * Type guard for ChatRole
+ */
+export declare function isChatRole(value: any): value is ChatRole;
+/**
+ * Type guard for ChatMessage
+ */
+export declare function isChatMessage(obj: any): obj is ChatMessage;
+/**
+ * Type guard for ChatSession
+ */
+export declare function isChatSession(obj: any): obj is ChatSession;
+/**
+ * Type guard for Model
+ */
+export declare function isModel(obj: any): obj is Model;
+/**
+ * Type guard for ClaudeModel enum values
+ */
+export declare function isClaudeModel(value: any): value is ClaudeModel;
+/**
+ * Type guard for SendMessageRequest
+ */
+export declare function isSendMessageRequest(obj: any): obj is SendMessageRequest;
+/**
+ * Type guard for CreateSessionRequest
+ */
+export declare function isCreateSessionRequest(obj: any): obj is CreateSessionRequest;
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../src/type-guards.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,KAAK,EACL,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,QAAQ,CAExD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,WAAW,CAY1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,WAAW,CAY1D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,KAAK,CAe9C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,WAAW,CAE9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,kBAAkB,CASxE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,oBAAoB,CAQ5E"}

package/dist/type-guards.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * Type Guards
+ * Runtime type checking for primitives
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isChatRole = isChatRole;
+exports.isChatMessage = isChatMessage;
+exports.isChatSession = isChatSession;
+exports.isModel = isModel;
+exports.isClaudeModel = isClaudeModel;
+exports.isSendMessageRequest = isSendMessageRequest;
+exports.isCreateSessionRequest = isCreateSessionRequest;
+const chat_types_1 = require("./chat.types");
+/**
+ * Type guard for ChatRole
+ */
+function isChatRole(value) {
+    return value === 'user' || value === 'assistant';
+}
+/**
+ * Type guard for ChatMessage
+ */
+function isChatMessage(obj) {
+    return (obj !== null &&
+        obj !== undefined &&
+        typeof obj === 'object' &&
+        typeof obj.id === 'string' &&
+        typeof obj.sessionId === 'string' &&
+        isChatRole(obj.role) &&
+        typeof obj.content === 'string' &&
+        obj.timestamp instanceof Date &&
+        (obj.model === undefined || typeof obj.model === 'string'));
+}
+/**
+ * Type guard for ChatSession
+ */
+function isChatSession(obj) {
+    return (obj !== null &&
+        obj !== undefined &&
+        typeof obj === 'object' &&
+        typeof obj.id === 'string' &&
+        typeof obj.userId === 'string' &&
+        typeof obj.model === 'string' &&
+        obj.createdAt instanceof Date &&
+        obj.updatedAt instanceof Date &&
+        (obj.title === undefined || typeof obj.title === 'string'));
+}
+/**
+ * Type guard for Model
+ */
+function isModel(obj) {
+    return (obj !== null &&
+        obj !== undefined &&
+        typeof obj === 'object' &&
+        obj.type === 'model' &&
+        typeof obj.id === 'string' &&
+        typeof obj.display_name === 'string' &&
+        typeof obj.created_at === 'string' &&
+        (obj.tier === undefined ||
+            obj.tier === 'fast' ||
+            obj.tier === 'balanced' ||
+            obj.tier === 'powerful' ||
+            obj.tier === 'expert'));
+}
+/**
+ * Type guard for ClaudeModel enum values
+ */
+function isClaudeModel(value) {
+    return Object.values(chat_types_1.ClaudeModel).includes(value);
+}
+/**
+ * Type guard for SendMessageRequest
+ */
+function isSendMessageRequest(obj) {
+    return (obj !== null &&
+        obj !== undefined &&
+        typeof obj === 'object' &&
+        (obj.sessionId === undefined || typeof obj.sessionId === 'string') &&
+        typeof obj.message === 'string' &&
+        typeof obj.model === 'string');
+}
+/**
+ * Type guard for CreateSessionRequest
+ */
+function isCreateSessionRequest(obj) {
+    return (obj !== null &&
+        obj !== undefined &&
+        typeof obj === 'object' &&
+        typeof obj.model === 'string' &&
+        (obj.title === undefined || typeof obj.title === 'string'));
+}

package/dist/type-guards.spec.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Type Guards Tests
+ */
+export {};
+//# sourceMappingURL=type-guards.spec.d.ts.map

package/dist/type-guards.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.spec.d.ts","sourceRoot":"","sources":["../src/type-guards.spec.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/type-guards.spec.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * Type Guards Tests
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const type_guards_1 = require("./type-guards");
+const chat_types_1 = require("./chat.types");
+describe('Type Guards', () => {
+    describe('isChatRole', () => {
+        it('should return true for valid chat roles', () => {
+            expect((0, type_guards_1.isChatRole)('user')).toBe(true);
+            expect((0, type_guards_1.isChatRole)('assistant')).toBe(true);
+        });
+        it('should return false for invalid values', () => {
+            expect((0, type_guards_1.isChatRole)('admin')).toBe(false);
+            expect((0, type_guards_1.isChatRole)('system')).toBe(false);
+            expect((0, type_guards_1.isChatRole)('')).toBe(false);
+            expect((0, type_guards_1.isChatRole)(null)).toBe(false);
+            expect((0, type_guards_1.isChatRole)(undefined)).toBe(false);
+            expect((0, type_guards_1.isChatRole)(123)).toBe(false);
+            expect((0, type_guards_1.isChatRole)({})).toBe(false);
+        });
+    });
+    describe('isChatMessage', () => {
+        const validMessage = {
+            id: 'msg_123',
+            sessionId: 'session_456',
+            role: 'user',
+            content: 'Hello, world!',
+            timestamp: new Date(),
+        };
+        it('should return true for valid ChatMessage', () => {
+            expect((0, type_guards_1.isChatMessage)(validMessage)).toBe(true);
+        });
+        it('should return true for ChatMessage with optional model', () => {
+            const messageWithModel = {
+                ...validMessage,
+                model: 'claude-sonnet-4-5-20250929',
+            };
+            expect((0, type_guards_1.isChatMessage)(messageWithModel)).toBe(true);
+        });
+        it('should return false for missing required fields', () => {
+            expect((0, type_guards_1.isChatMessage)({ ...validMessage, id: undefined })).toBe(false);
+            expect((0, type_guards_1.isChatMessage)({ ...validMessage, sessionId: undefined })).toBe(false);
+            expect((0, type_guards_1.isChatMessage)({ ...validMessage, role: undefined })).toBe(false);
+            expect((0, type_guards_1.isChatMessage)({ ...validMessage, content: undefined })).toBe(false);
+            expect((0, type_guards_1.isChatMessage)({ ...validMessage, timestamp: undefined })).toBe(false);
+        });
+        it('should return false for invalid field types', () => {
+            expect((0, type_guards_1.isChatMessage)({ ...validMessage, id: 123 })).toBe(false);
+            expect((0, type_guards_1.isChatMessage)({ ...validMessage, sessionId: 123 })).toBe(false);
+            expect((0, type_guards_1.isChatMessage)({ ...validMessage, role: 'invalid' })).toBe(false);
+            expect((0, type_guards_1.isChatMessage)({ ...validMessage, content: 123 })).toBe(false);
+            expect((0, type_guards_1.isChatMessage)({ ...validMessage, timestamp: '2025-01-01' })).toBe(false);
+            expect((0, type_guards_1.isChatMessage)({ ...validMessage, model: 123 })).toBe(false);
+        });
+        it('should return false for null and undefined', () => {
+            expect((0, type_guards_1.isChatMessage)(null)).toBe(false);
+            expect((0, type_guards_1.isChatMessage)(undefined)).toBe(false);
+        });
+        it('should return false for non-object values', () => {
+            expect((0, type_guards_1.isChatMessage)('message')).toBe(false);
+            expect((0, type_guards_1.isChatMessage)(123)).toBe(false);
+            expect((0, type_guards_1.isChatMessage)(true)).toBe(false);
+        });
+    });
+    describe('isChatSession', () => {
+        const validSession = {
+            id: 'session_123',
+            userId: 'user_456',
+            model: 'claude-sonnet-4-5-20250929',
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        };
+        it('should return true for valid ChatSession', () => {
+            expect((0, type_guards_1.isChatSession)(validSession)).toBe(true);
+        });
+        it('should return true for ChatSession with optional title', () => {
+            const sessionWithTitle = {
+                ...validSession,
+                title: 'My Chat Session',
+            };
+            expect((0, type_guards_1.isChatSession)(sessionWithTitle)).toBe(true);
+        });
+        it('should return false for missing required fields', () => {
+            expect((0, type_guards_1.isChatSession)({ ...validSession, id: undefined })).toBe(false);
+            expect((0, type_guards_1.isChatSession)({ ...validSession, userId: undefined })).toBe(false);
+            expect((0, type_guards_1.isChatSession)({ ...validSession, model: undefined })).toBe(false);
+            expect((0, type_guards_1.isChatSession)({ ...validSession, createdAt: undefined })).toBe(false);
+            expect((0, type_guards_1.isChatSession)({ ...validSession, updatedAt: undefined })).toBe(false);
+        });
+        it('should return false for invalid field types', () => {
+            expect((0, type_guards_1.isChatSession)({ ...validSession, id: 123 })).toBe(false);
+            expect((0, type_guards_1.isChatSession)({ ...validSession, userId: 123 })).toBe(false);
+            expect((0, type_guards_1.isChatSession)({ ...validSession, model: 123 })).toBe(false);
+            expect((0, type_guards_1.isChatSession)({ ...validSession, createdAt: '2025-01-01' })).toBe(false);
+            expect((0, type_guards_1.isChatSession)({ ...validSession, updatedAt: '2025-01-01' })).toBe(false);
+            expect((0, type_guards_1.isChatSession)({ ...validSession, title: 123 })).toBe(false);
+        });
+        it('should return false for null and undefined', () => {
+            expect((0, type_guards_1.isChatSession)(null)).toBe(false);
+            expect((0, type_guards_1.isChatSession)(undefined)).toBe(false);
+        });
+    });
+    describe('isModel', () => {
+        const validModel = {
+            type: 'model',
+            id: 'claude-sonnet-4-5-20250929',
+            display_name: 'Claude Sonnet 4.5',
+            created_at: '2025-09-29T00:00:00Z',
+        };
+        it('should return true for valid Model', () => {
+            expect((0, type_guards_1.isModel)(validModel)).toBe(true);
+        });
+        it('should return true for Model with optional tier', () => {
+            expect((0, type_guards_1.isModel)({ ...validModel, tier: 'fast' })).toBe(true);
+            expect((0, type_guards_1.isModel)({ ...validModel, tier: 'balanced' })).toBe(true);
+            expect((0, type_guards_1.isModel)({ ...validModel, tier: 'powerful' })).toBe(true);
+            expect((0, type_guards_1.isModel)({ ...validModel, tier: 'expert' })).toBe(true);
+        });
+        it('should return false for missing required fields', () => {
+            expect((0, type_guards_1.isModel)({ ...validModel, type: undefined })).toBe(false);
+            expect((0, type_guards_1.isModel)({ ...validModel, id: undefined })).toBe(false);
+            expect((0, type_guards_1.isModel)({ ...validModel, display_name: undefined })).toBe(false);
+            expect((0, type_guards_1.isModel)({ ...validModel, created_at: undefined })).toBe(false);
+        });
+        it('should return false for invalid type value', () => {
+            expect((0, type_guards_1.isModel)({ ...validModel, type: 'invalid' })).toBe(false);
+            expect((0, type_guards_1.isModel)({ ...validModel, type: 'user' })).toBe(false);
+        });
+        it('should return false for invalid tier value', () => {
+            expect((0, type_guards_1.isModel)({ ...validModel, tier: 'invalid' })).toBe(false);
+            expect((0, type_guards_1.isModel)({ ...validModel, tier: 'super-fast' })).toBe(false);
+        });
+        it('should return false for null and undefined', () => {
+            expect((0, type_guards_1.isModel)(null)).toBe(false);
+            expect((0, type_guards_1.isModel)(undefined)).toBe(false);
+        });
+    });
+    describe('isClaudeModel', () => {
+        it('should return true for valid ClaudeModel enum values', () => {
+            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.HAIKU_3_5)).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.SONNET_3_5)).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.SONNET_3_7)).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.OPUS_3)).toBe(true);
+        });
+        it('should return true for valid model ID strings', () => {
+            expect((0, type_guards_1.isClaudeModel)('claude-3-5-haiku-20241022')).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)('claude-3-5-sonnet-20241022')).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)('claude-3-5-sonnet-20250219')).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)('claude-3-opus-20240229')).toBe(true);
+        });
+        it('should return false for invalid model IDs', () => {
+            expect((0, type_guards_1.isClaudeModel)('claude-4-sonnet')).toBe(false);
+            expect((0, type_guards_1.isClaudeModel)('gpt-4')).toBe(false);
+            expect((0, type_guards_1.isClaudeModel)('invalid-model')).toBe(false);
+            expect((0, type_guards_1.isClaudeModel)('')).toBe(false);
+        });
+        it('should return false for non-string values', () => {
+            expect((0, type_guards_1.isClaudeModel)(null)).toBe(false);
+            expect((0, type_guards_1.isClaudeModel)(undefined)).toBe(false);
+            expect((0, type_guards_1.isClaudeModel)(123)).toBe(false);
+            expect((0, type_guards_1.isClaudeModel)({})).toBe(false);
+        });
+    });
+    describe('isSendMessageRequest', () => {
+        const validRequest = {
+            message: 'Hello, Claude!',
+            model: 'claude-sonnet-4-5-20250929',
+        };
+        it('should return true for valid SendMessageRequest', () => {
+            expect((0, type_guards_1.isSendMessageRequest)(validRequest)).toBe(true);
+        });
+        it('should return true with optional sessionId', () => {
+            const requestWithSession = {
+                ...validRequest,
+                sessionId: 'session_123',
+            };
+            expect((0, type_guards_1.isSendMessageRequest)(requestWithSession)).toBe(true);
+        });
+        it('should return false for missing required fields', () => {
+            expect((0, type_guards_1.isSendMessageRequest)({ ...validRequest, message: undefined })).toBe(false);
+            expect((0, type_guards_1.isSendMessageRequest)({ ...validRequest, model: undefined })).toBe(false);
+        });
+        it('should return false for invalid field types', () => {
+            expect((0, type_guards_1.isSendMessageRequest)({ ...validRequest, message: 123 })).toBe(false);
+            expect((0, type_guards_1.isSendMessageRequest)({ ...validRequest, model: 123 })).toBe(false);
+            expect((0, type_guards_1.isSendMessageRequest)({ ...validRequest, sessionId: 123 })).toBe(false);
+        });
+        it('should return false for null and undefined', () => {
+            expect((0, type_guards_1.isSendMessageRequest)(null)).toBe(false);
+            expect((0, type_guards_1.isSendMessageRequest)(undefined)).toBe(false);
+        });
+    });
+    describe('isCreateSessionRequest', () => {
+        const validRequest = {
+            model: 'claude-sonnet-4-5-20250929',
+        };
+        it('should return true for valid CreateSessionRequest', () => {
+            expect((0, type_guards_1.isCreateSessionRequest)(validRequest)).toBe(true);
+        });
+        it('should return true with optional title', () => {
+            const requestWithTitle = {
+                ...validRequest,
+                title: 'My Session',
+            };
+            expect((0, type_guards_1.isCreateSessionRequest)(requestWithTitle)).toBe(true);
+        });
+        it('should return false for missing required fields', () => {
+            expect((0, type_guards_1.isCreateSessionRequest)({ ...validRequest, model: undefined })).toBe(false);
+            expect((0, type_guards_1.isCreateSessionRequest)({})).toBe(false);
+        });
+        it('should return false for invalid field types', () => {
+            expect((0, type_guards_1.isCreateSessionRequest)({ ...validRequest, model: 123 })).toBe(false);
+            expect((0, type_guards_1.isCreateSessionRequest)({ ...validRequest, title: 123 })).toBe(false);
+        });
+        it('should return false for null and undefined', () => {
+            expect((0, type_guards_1.isCreateSessionRequest)(null)).toBe(false);
+            expect((0, type_guards_1.isCreateSessionRequest)(undefined)).toBe(false);
+        });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guinetik/primitives-ts",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Shared TypeScript primitives for Guinetik projects",
   "author": "Guinetik",
   "license": "MIT",
@@ -11,6 +11,10 @@
   ],
   "scripts": {
     "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "pre-commit": "npm run test && npm run build",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -20,6 +24,9 @@
     "guinetik"
   ],
   "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.5",
     "typescript": "^5.9.3"
   },
   "repository": {