@guinetik/primitives-ts 0.8.3 → 0.9.0

package/README.md

@@ -40,31 +40,105 @@ const metrics: SystemMetrics = {
 };
 ```
 
-## Type Categories
-
-### Authentication (`auth.types.ts`)
-- `User` - User information
-- `AuthResponse` - Authentication response
-- `AuthProvider` - Authentication provider types
-- `UserUpdateData` - User profile update data
-- `LoginPayload` - Login request payload
-
-### System Monitoring (`system.types.ts`)
-- `SystemMetrics` - System metrics (CPU, memory, disk)
-- `Container` - Docker container information
-- `LogEntry` - Container log entry
-- `NetworkStats` - Network statistics
-- `DeploymentInfo` - Deployment information
-- `CommandResult` - Shell command execution result
-
-### Website Content (`website.types.ts`)
-- `SiteContent` - Full site content structure
-- `SiteMetadata` - Site metadata
-- `Menu`, `MenuItem` - Navigation menu
-- `Theme`, `ThemeConfig` - Theme configuration
-- `Card`, `Tag` - Project/demo cards with tags
-- `Experiment` - CodePen experiments
-- `AboutSection`, `ProjectsSection`, `DemosSection`, `ReposSection` - Content sections
+## Concept Catalog
+
+`primitives-ts` is the contract layer of the Guinetik stack. Every type below is
+consumed by at least two of: the NestJS API, the Vue admin panel, the Firestore
+migration tooling, and guinetik.com itself.
+
+```mermaid
+flowchart LR
+  P[primitives-ts]
+  P --> ID[Identity]
+  P --> CO[Content]
+  P --> OP[Operations]
+  P --> AS[Assistant]
+  P --> ST[Storage]
+
+  ID --> ID1[auth]
+  ID --> ID2[access]
+  ID --> ID3[totp]
+  ID --> ID4[security]
+
+  CO --> CO1[website]
+  CO --> CO2[launchpad]
+  CO --> CO3[files]
+
+  OP --> OP1[system]
+  OP --> OP2[agents]
+  OP --> OP3[deployments]
+  OP --> OP4[github]
+
+  AS --> AS1[chat]
+  AS --> AS2[guards]
+
+  ST --> ST1[firestore]
+```
+
+### How the domains relate
+
+```mermaid
+flowchart LR
+  A[auth<br/>who you are] --> B[access<br/>what you may do]
+  T[totp<br/>second factor] --> A
+  B --> F[FeatureKey]
+  F --> C[Content]
+  F --> O[Operations]
+  F --> X[Assistant]
+  C --> S[(firestore)]
+  X --> S
+```
+
+Authentication proves identity, access control turns that identity into a set of
+`FeatureKey` grants, and every other domain is gated by one of those keys. The
+Firestore document types are the persisted shape of whatever the other domains
+produce.
+
+---
+
+### Identity & Access
+
+| Module | Key exports | Purpose |
+| --- | --- | --- |
+| `auth.types` | `User`, `AuthResponse`, `LoginPayload`, `AuthProvider`, `UserProvider` | Firebase-backed sign-in, email or Google |
+| `access.types` | `AdminRole`, `FeatureKey`, `FEATURE_CATALOG`, `AdminUser`, `userHasFeature` | Role plus per-feature grants for the admin panel |
+| `totp.types` | `TotpSetupResponse`, `TotpVerifyRequest`, `TotpStatusResponse` | Time-based one-time password enrolment and checks |
+| `security.interface` | `Security`, `SecurityLevel`, `SecurityChallengeResult` | Provider-agnostic challenge contract |
+
+An `AdminUser` is an `admin` or a `guest`; a guest sees only the features
+explicitly granted to it. The nine grantable features are `dashboard`, `site`,
+`runtime`, `files`, `launchpad`, `users`, `system`, `chat` and `agents`.
+
+### Content
+
+| Module | Key exports | Purpose |
+| --- | --- | --- |
+| `website.types` | `SiteContent`, `SiteMetadata`, `SiteSections`, `Menu`, `Theme`, `Card` | Everything guinetik.com renders |
+| `website-firestore.types` | `ProjectDocument`, `DemoDocument`, `FIRESTORE_COLLECTIONS` | The stored counterparts of the above |
+| `launchpad.types` | `LaunchpadBoard`, `LaunchpadGroup`, `LaunchpadItem` | Bookmark board grouping and layout |
+| `file.types` | `FileMetadata`, `FileUploadResponse`, `FileUploadProgress` | Uploads and their lifecycle |
+
+### Operations
+
+| Module | Key exports | Purpose |
+| --- | --- | --- |
+| `system.types` | `SystemMetrics`, `Container`, `LogEntry`, `NetworkStats`, `CommandResult` | Host and Docker telemetry |
+| `agent.types` | `AgentInfo`, `AgentStatus`, `AgentTask`, `AgentTasksResponse` | Autonomous agent fleet monitoring |
+| `deployment-history.types` | `DeploymentRecord`, `DeploymentHistoryResponse` | What shipped, when, and whether it held |
+| `github.types` | `GitHubRepository`, `GitHubOwner`, `GitHubLicense` | The subset of the GitHub REST shape we consume |
+
+### Assistant
+
+| Module | Key exports | Purpose |
+| --- | --- | --- |
+| `chat.types` | `ChatSession`, `ChatMessage`, `ClaudeModel`, `SendMessageRequest` | Session-based chat with model selection |
+| `type-guards` | `isChatMessage`, `isChatSession`, `isModel`, `isClaudeModel` | Runtime validation at the API boundary |
+
+### Storage
+
+| Module | Key exports | Purpose |
+| --- | --- | --- |
+| `firestore.types` | `FirestoreDocument`, `FirestoreCollection` | Base document shape every stored type extends |
 
 ## Development
 

package/dist/access.types.d.ts

@@ -9,7 +9,7 @@ export type AdminUserStatus = 'invited' | 'active' | 'disabled';
 /** Avatar resolution strategy for admin users. */
 export type AvatarSource = 'gravatar' | 'google' | 'custom';
 /** Feature keys that gate admin panel pages and API areas. */
-export type FeatureKey = 'dashboard' | 'site' | 'runtime' | 'files' | 'launchpad' | 'users' | 'system' | 'chat' | 'agents';
+export type FeatureKey = 'dashboard' | 'site' | 'runtime' | 'files' | 'launchpad' | 'users' | 'system' | 'chat' | 'agents' | 'email';
 /** Canonical ordered list of grantable features. */
 export declare const FEATURE_CATALOG: readonly FeatureKey[];
 /** Human-readable labels for feature checklist UI. */

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

@@ -1 +1 @@
-{"version":3,"file":"access.types.d.ts","sourceRoot":"","sources":["../src/access.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"access.types.d.ts","sourceRoot":"","sources":["../src/access.types.ts"],"names":[],"mappings":"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"}

package/dist/access.types.js

@@ -21,6 +21,7 @@ exports.FEATURE_CATALOG = [
     'system',
     'chat',
     'agents',
+    'email',
 ];
 /** Human-readable labels for feature checklist UI. */
 exports.FEATURE_LABELS = {
@@ -33,6 +34,7 @@ exports.FEATURE_LABELS = {
     system: 'System monitoring',
     chat: 'Chat',
     agents: 'Agents',
+    email: 'Email',
 };
 /**
  * Returns true when the value is a known feature key.

package/dist/access.types.spec.js

@@ -33,6 +33,13 @@ describe('access.types', () => {
     });
     it('exposes a stable feature catalog', () => {
         expect(access_types_1.FEATURE_CATALOG).toContain('users');
-        expect(access_types_1.FEATURE_CATALOG.length).toBe(9);
+        expect(access_types_1.FEATURE_CATALOG.length).toBe(10);
+    });
+});
+describe('email feature key', () => {
+    it('includes email in the catalog with a label', () => {
+        expect(access_types_1.FEATURE_CATALOG).toContain('email');
+        expect(access_types_1.FEATURE_LABELS.email).toBe('Email');
+        expect((0, access_types_1.isFeatureKey)('email')).toBe(true);
     });
 });

package/dist/chat.types.d.ts

@@ -20,14 +20,14 @@ export interface Model {
  * @deprecated Use Model type instead
  */
 export declare enum ClaudeModel {
-    /** Claude Haiku 3.5 - Fastest, most cost-effective */
-    HAIKU_3_5 = "claude-3-5-haiku-20241022",
-    /** Claude Sonnet 3.5 - Balanced performance and quality */
-    SONNET_3_5 = "claude-3-5-sonnet-20241022",
-    /** Claude Sonnet 3.7 - Extended thinking capability */
-    SONNET_3_7 = "claude-3-5-sonnet-20250219",
-    /** Claude Opus 3 - Most powerful model for complex reasoning */
-    OPUS_3 = "claude-3-opus-20240229"
+    /** Claude Haiku 4.5 - Fastest, most cost-effective */
+    HAIKU_4_5 = "claude-haiku-4-5",
+    /** Claude Sonnet 5 - Balanced performance and quality */
+    SONNET_5 = "claude-sonnet-5",
+    /** Claude Opus 5 - Powerful reasoning, adaptive thinking on by default */
+    OPUS_5 = "claude-opus-5",
+    /** Claude Fable 5 - Most capable model, premium pricing */
+    FABLE_5 = "claude-fable-5"
 }
 /**
  * Model metadata for display in UI
@@ -55,7 +55,7 @@ export interface ChatSession {
     id: string;
     /** User ID who created the session */
     userId: string;
-    /** Current model ID for the session (e.g., "claude-sonnet-4-5-20250929") */
+    /** Current model ID for the session (e.g., "claude-opus-5") */
     model: string;
     /** Session creation timestamp */
     createdAt: Date;
@@ -89,7 +89,7 @@ export interface SendMessageRequest {
     sessionId?: string;
     /** User message content */
     message: string;
-    /** Model ID to use for response (e.g., "claude-sonnet-4-5-20250929") */
+    /** Model ID to use for response (e.g., "claude-opus-5") */
     model: string;
 }
 /**
@@ -127,7 +127,7 @@ export interface GetSessionMessagesResponse {
  * Create new session request
  */
 export interface CreateSessionRequest {
-    /** Initial model ID for the session (e.g., "claude-sonnet-4-5-20250929") */
+    /** Initial model ID for the session (e.g., "claude-opus-5") */
     model: string;
     /** Optional session title */
     title?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../src/chat.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;CACpD;AAED;;;GAGG;AACH,oBAAY,WAAW;IACrB,sDAAsD;IACtD,SAAS,8BAA8B;IAEvC,2DAA2D;IAC3D,UAAU,+BAA+B;IAEzC,uDAAuD;IACvD,UAAU,+BAA+B;IAEzC,gEAAgE;IAChE,MAAM,2BAA2B;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,eAAe;IACf,EAAE,EAAE,WAAW,CAAC;IAEhB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IAEX,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IAEd,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;IAEhB,4BAA4B;IAC5B,SAAS,EAAE,IAAI,CAAC;IAEhB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IAEX,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAElB,mBAAmB;IACnB,IAAI,EAAE,QAAQ,CAAC;IAEf,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAC;IAEhB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAEhB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IAEtB,2BAA2B;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4BAA4B;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,sCAAsC;IACtC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IAEd,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,EAAE,CAAC;CACrC"}
+{"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../src/chat.types.ts"],"names":[],"mappings":"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"}

package/dist/chat.types.js

@@ -11,12 +11,12 @@ exports.ClaudeModel = void 0;
  */
 var ClaudeModel;
 (function (ClaudeModel) {
-    /** Claude Haiku 3.5 - Fastest, most cost-effective */
-    ClaudeModel["HAIKU_3_5"] = "claude-3-5-haiku-20241022";
-    /** Claude Sonnet 3.5 - Balanced performance and quality */
-    ClaudeModel["SONNET_3_5"] = "claude-3-5-sonnet-20241022";
-    /** Claude Sonnet 3.7 - Extended thinking capability */
-    ClaudeModel["SONNET_3_7"] = "claude-3-5-sonnet-20250219";
-    /** Claude Opus 3 - Most powerful model for complex reasoning */
-    ClaudeModel["OPUS_3"] = "claude-3-opus-20240229";
+    /** Claude Haiku 4.5 - Fastest, most cost-effective */
+    ClaudeModel["HAIKU_4_5"] = "claude-haiku-4-5";
+    /** Claude Sonnet 5 - Balanced performance and quality */
+    ClaudeModel["SONNET_5"] = "claude-sonnet-5";
+    /** Claude Opus 5 - Powerful reasoning, adaptive thinking on by default */
+    ClaudeModel["OPUS_5"] = "claude-opus-5";
+    /** Claude Fable 5 - Most capable model, premium pricing */
+    ClaudeModel["FABLE_5"] = "claude-fable-5";
 })(ClaudeModel || (exports.ClaudeModel = ClaudeModel = {}));

package/dist/chat.types.spec.js

@@ -17,35 +17,35 @@ describe('Chat Types', () => {
             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 HAIKU_4_5 with correct ID', () => {
+            expect(chat_types_1.ClaudeModel.HAIKU_4_5).toBe('claude-haiku-4-5');
         });
-        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_5 with correct ID', () => {
+            expect(chat_types_1.ClaudeModel.SONNET_5).toBe('claude-sonnet-5');
         });
-        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_5 with correct ID', () => {
+            expect(chat_types_1.ClaudeModel.OPUS_5).toBe('claude-opus-5');
         });
-        it('should have OPUS_3 with correct ID', () => {
-            expect(chat_types_1.ClaudeModel.OPUS_3).toBe('claude-3-opus-20240229');
+        it('should have FABLE_5 with correct ID', () => {
+            expect(chat_types_1.ClaudeModel.FABLE_5).toBe('claude-fable-5');
         });
         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', () => {
+        it('should not carry legacy date suffixes', () => {
             const allModels = Object.values(chat_types_1.ClaudeModel);
-            const datePattern = /\d{8}$/; // YYYYMMDD at the end
+            const datePattern = /-\d{8}$/; // legacy YYYYMMDD snapshot suffix
             allModels.forEach((modelId) => {
-                expect(modelId).toMatch(datePattern);
+                expect(modelId).not.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();
+            expect(chat_types_1.ClaudeModel['HAIKU_4_5']).toBeDefined();
+            expect(chat_types_1.ClaudeModel['SONNET_5']).toBeDefined();
+            expect(chat_types_1.ClaudeModel['OPUS_5']).toBeDefined();
+            expect(chat_types_1.ClaudeModel['FABLE_5']).toBeDefined();
         });
         it('should support iteration over enum values', () => {
             const models = [];
@@ -53,10 +53,10 @@ describe('Chat Types', () => {
                 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');
+            expect(models).toContain('claude-haiku-4-5');
+            expect(models).toContain('claude-sonnet-5');
+            expect(models).toContain('claude-opus-5');
+            expect(models).toContain('claude-fable-5');
         });
     });
     describe('Model Tier Values', () => {

package/dist/email.types.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Email module types: provider configuration, sending, and API keys.
+ */
+import type { FirestoreDocument } from './firestore.types';
+/** Supported outbound email providers. */
+export type EmailProviderType = 'resend' | 'mailersend' | 'smtp';
+/** Settings shared by every provider type. */
+export interface EmailProviderSettingsBase {
+    fromEmail: string;
+    fromName?: string;
+}
+/** Resend (https://resend.com) settings. */
+export interface ResendSettings extends EmailProviderSettingsBase {
+    apiKey: string;
+}
+/** MailerSend (https://mailersend.com) settings. */
+export interface MailerSendSettings extends EmailProviderSettingsBase {
+    apiKey: string;
+}
+/** Generic SMTP settings (nodemailer). */
+export interface SmtpSettings extends EmailProviderSettingsBase {
+    host: string;
+    port: number;
+    secure: boolean;
+    username: string;
+    password: string;
+}
+export type EmailProviderSettings = ResendSettings | MailerSendSettings | SmtpSettings;
+/** A configured provider with decrypted settings (server-internal). */
+export interface EmailProviderConfig {
+    id: string;
+    type: EmailProviderType;
+    name: string;
+    enabled: boolean;
+    settings: EmailProviderSettings;
+}
+/** Provider settings safe to return to clients (no secrets). */
+export interface EmailProviderPublicSettings {
+    fromEmail: string;
+    fromName?: string;
+    host?: string;
+    port?: number;
+    secure?: boolean;
+    username?: string;
+}
+/** Provider config as exposed by the API: secrets stripped, flags instead. */
+export interface EmailProviderConfigPublic {
+    id: string;
+    type: EmailProviderType;
+    name: string;
+    enabled: boolean;
+    active: boolean;
+    settings: EmailProviderPublicSettings;
+    hasApiKey: boolean;
+    hasPassword: boolean;
+}
+/** Payload for POST /email/send and the admin test send. */
+export interface SendEmailRequest {
+    to: string[];
+    subject: string;
+    html: string;
+    text?: string;
+    /** Optional from-address override; defaults to the provider's fromEmail. */
+    from?: string;
+}
+/** Result of a successful send. */
+export interface SendEmailResult {
+    id: string;
+    provider: EmailProviderType;
+    accepted: string[];
+    timestamp: string;
+}
+/** Result of a provider connection check. */
+export interface EmailVerifyResult {
+    ok: boolean;
+    error?: string;
+}
+/** API key metadata — never contains the full key. */
+export interface EmailApiKey {
+    id: string;
+    name: string;
+    /** Free-form attribution label (e.g. agents@guinetik.com). Not an account link. */
+    owner?: string;
+    prefix: string;
+    createdAt: string;
+    lastUsedAt?: string;
+}
+/** Returned once, at creation time only. */
+export interface EmailApiKeyCreated extends EmailApiKey {
+    key: string;
+}
+/** email-providers doc. Secret fields stored as enc:v1:... strings. */
+export interface EmailProviderDocument extends FirestoreDocument {
+    type: EmailProviderType;
+    name: string;
+    enabled: boolean;
+    settings: Record<string, string | number | boolean>;
+}
+/** email-settings singleton doc. */
+export interface EmailSettingsDocument extends FirestoreDocument {
+    activeProviderId: string | null;
+}
+/** email-api-keys doc. */
+export interface EmailApiKeyDocument extends FirestoreDocument {
+    name: string;
+    owner?: string;
+    keyHash: string;
+    prefix: string;
+    lastUsedAt?: Date;
+}
+//# sourceMappingURL=email.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email.types.d.ts","sourceRoot":"","sources":["../src/email.types.ts"],"names":[],"mappings":"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"}

package/dist/email.types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Email module types: provider configuration, sending, and API keys.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -21,6 +21,7 @@ export * from './type-guards';
 export * from './agent.types';
 export * from './file.types';
 export * from './launchpad.types';
+export * from './email.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,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,cAAc,mBAAmB,CAAC;AAGlC,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,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,cAAc,mBAAmB,CAAC;AAGlC,cAAc,eAAe,CAAC;AAG9B,YAAY,EAAE,QAAQ,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -52,5 +52,7 @@ __exportStar(require("./agent.types"), exports);
 __exportStar(require("./file.types"), exports);
 // Launchpad bookmark board types
 __exportStar(require("./launchpad.types"), exports);
+// Email module types
+__exportStar(require("./email.types"), exports);
 var security_interface_1 = require("./security.interface");
 Object.defineProperty(exports, "SecurityLevel", { enumerable: true, get: function () { return security_interface_1.SecurityLevel; } });

package/dist/type-guards.spec.js

@@ -35,7 +35,7 @@ describe('Type Guards', () => {
         it('should return true for ChatMessage with optional model', () => {
             const messageWithModel = {
                 ...validMessage,
-                model: 'claude-sonnet-4-5-20250929',
+                model: 'claude-opus-5',
             };
             expect((0, type_guards_1.isChatMessage)(messageWithModel)).toBe(true);
         });
@@ -68,7 +68,7 @@ describe('Type Guards', () => {
         const validSession = {
             id: 'session_123',
             userId: 'user_456',
-            model: 'claude-sonnet-4-5-20250929',
+            model: 'claude-opus-5',
             createdAt: new Date(),
             updatedAt: new Date(),
         };
@@ -105,7 +105,7 @@ describe('Type Guards', () => {
     describe('isModel', () => {
         const validModel = {
             type: 'model',
-            id: 'claude-sonnet-4-5-20250929',
+            id: 'claude-opus-5',
             display_name: 'Claude Sonnet 4.5',
             created_at: '2025-09-29T00:00:00Z',
         };
@@ -139,19 +139,19 @@ describe('Type Guards', () => {
     });
     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);
+            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.HAIKU_4_5)).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.SONNET_5)).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.OPUS_5)).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)(chat_types_1.ClaudeModel.FABLE_5)).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);
+            expect((0, type_guards_1.isClaudeModel)('claude-haiku-4-5')).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)('claude-sonnet-5')).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)('claude-opus-5')).toBe(true);
+            expect((0, type_guards_1.isClaudeModel)('claude-fable-5')).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)('claude-3-opus-20240229')).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);
@@ -166,7 +166,7 @@ describe('Type Guards', () => {
     describe('isSendMessageRequest', () => {
         const validRequest = {
             message: 'Hello, Claude!',
-            model: 'claude-sonnet-4-5-20250929',
+            model: 'claude-opus-5',
         };
         it('should return true for valid SendMessageRequest', () => {
             expect((0, type_guards_1.isSendMessageRequest)(validRequest)).toBe(true);
@@ -194,7 +194,7 @@ describe('Type Guards', () => {
     });
     describe('isCreateSessionRequest', () => {
         const validRequest = {
-            model: 'claude-sonnet-4-5-20250929',
+            model: 'claude-opus-5',
         };
         it('should return true for valid CreateSessionRequest', () => {
             expect((0, type_guards_1.isCreateSessionRequest)(validRequest)).toBe(true);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guinetik/primitives-ts",
-  "version": "0.8.3",
+  "version": "0.9.0",
   "description": "Shared TypeScript primitives for Guinetik projects",
   "author": "Guinetik",
   "license": "MIT",