@mrck-labs/vanaheim-shared 0.1.1

package/dist/types/index.d.ts

@@ -0,0 +1,135 @@
+export { s as BankConnection, B as BankConnectionStatus, t as BankTransaction, k as ChatConversation, m as ChatMessage, C as ChatMessageRole, o as EFLink, u as ExchangeRate, a as Expense, E as ExpenseCategory, F as FocusCategory, h as FocusSession, j as FocusSessionFilters, g as FocusSessionStatus, d as Income, I as IncomeCategory, q as LieuDay, L as LieuDayType, l as NewChatConversation, n as NewChatMessage, p as NewEFLink, b as NewExpense, N as NewExpenseCategory, f as NewFocusCategory, i as NewFocusSession, e as NewIncome, c as NewIncomeCategory, r as NewLieuDay, S as Setting, T as TransactionType } from '../database-BKc0Oj26.js';
+
+/**
+ * Cursor Cloud API Types
+ *
+ * Types for interacting with Cursor's Cloud Agents API.
+ */
+type CloudAgentStatus = 'CREATING' | 'RUNNING' | 'FINISHED' | 'FAILED' | 'CANCELLED';
+type CloudAgentModel = 'claude-4-opus-thinking' | 'claude-4.5-opus-high-thinking' | 'claude-4-sonnet-thinking' | 'o3';
+interface CloudAgentSource {
+    repository: string;
+    ref: string;
+}
+interface CloudAgentTarget {
+    branchName?: string;
+    url?: string | null;
+    prUrl?: string | null;
+    autoCreatePr: boolean;
+    openAsCursorGithubApp?: boolean;
+    skipReviewerRequest?: boolean;
+}
+interface CloudAgent {
+    id: string;
+    name: string | null;
+    status: CloudAgentStatus;
+    source: CloudAgentSource;
+    target: CloudAgentTarget;
+    summary?: string | null;
+    createdAt: string;
+}
+type CloudAgentMessageType = 'user_message' | 'assistant_message';
+interface CloudAgentMessage {
+    id: string;
+    type: CloudAgentMessageType;
+    text: string;
+    createdAt?: string;
+}
+interface CloudAgentConversation {
+    id?: string;
+    agentId?: string;
+    messages: CloudAgentMessage[];
+}
+interface CloudAgentPrompt {
+    text: string;
+    images?: Array<{
+        data: string;
+        dimension: {
+            width: number;
+            height: number;
+        };
+    }>;
+}
+interface LaunchAgentRequest {
+    prompt: CloudAgentPrompt;
+    source: CloudAgentSource;
+    target?: {
+        autoCreatePr?: boolean;
+        branchName?: string;
+        openAsCursorGithubApp?: boolean;
+        skipReviewerRequest?: boolean;
+    };
+    model?: CloudAgentModel;
+}
+interface ListAgentsResponse {
+    agents: CloudAgent[];
+    nextCursor?: string;
+    hasMore?: boolean;
+}
+interface ModelsResponse {
+    models: string[];
+}
+interface ApiKeyInfo {
+    apiKeyName?: string;
+    email?: string;
+    userEmail?: string;
+    createdAt?: string;
+    usage?: {
+        current: number;
+        limit: number;
+    };
+}
+
+/**
+ * Linear API Types
+ *
+ * Types for interacting with Linear's GraphQL API.
+ */
+interface LinearUser {
+    id: string;
+    name: string;
+    email: string;
+    avatarUrl: string | null;
+}
+interface LinearProject {
+    id: string;
+    name: string;
+    color: string;
+}
+type LinearStateType = 'backlog' | 'unstarted' | 'started' | 'completed' | 'canceled';
+interface LinearState {
+    id: string;
+    name: string;
+    color: string;
+    type: LinearStateType;
+}
+type LinearPriority = 0 | 1 | 2 | 3 | 4;
+declare const LINEAR_PRIORITY_LABELS: Record<LinearPriority, string>;
+interface LinearIssue {
+    id: string;
+    identifier: string;
+    title: string;
+    description: string | null;
+    priority: LinearPriority;
+    priorityLabel: string;
+    dueDate: string | null;
+    url: string;
+    state: LinearState | null;
+    project: LinearProject | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface IssueQueryOptions {
+    projectId?: string;
+    search?: string;
+    cursor?: string;
+    limit?: number;
+}
+interface PaginatedIssues {
+    issues: LinearIssue[];
+    hasNextPage: boolean;
+    endCursor: string | null;
+    totalCount: number;
+}
+
+export { type ApiKeyInfo, type CloudAgent, type CloudAgentConversation, type CloudAgentMessage, type CloudAgentMessageType, type CloudAgentModel, type CloudAgentPrompt, type CloudAgentSource, type CloudAgentStatus, type CloudAgentTarget, type IssueQueryOptions, LINEAR_PRIORITY_LABELS, type LaunchAgentRequest, type LinearIssue, type LinearPriority, type LinearProject, type LinearState, type LinearStateType, type LinearUser, type ListAgentsResponse, type ModelsResponse, type PaginatedIssues };

package/dist/types/index.js

@@ -0,0 +1,39 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types/index.ts
+var types_exports = {};
+__export(types_exports, {
+  LINEAR_PRIORITY_LABELS: () => LINEAR_PRIORITY_LABELS
+});
+module.exports = __toCommonJS(types_exports);
+
+// src/types/linear.ts
+var LINEAR_PRIORITY_LABELS = {
+  0: "No priority",
+  1: "Urgent",
+  2: "High",
+  3: "Medium",
+  4: "Low"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LINEAR_PRIORITY_LABELS
+});
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts","../../src/types/linear.ts"],"sourcesContent":["/**\n * Types Index\n *\n * Re-exports all shared types.\n */\n\n// Database types\nexport * from \"./database\";\n\n// API types\nexport * from \"./cursor-cloud\";\nexport * from \"./linear\";\n","/**\n * Linear API Types\n *\n * Types for interacting with Linear's GraphQL API.\n */\n\n// ============================================================================\n// User Types\n// ============================================================================\n\nexport interface LinearUser {\n  id: string\n  name: string\n  email: string\n  avatarUrl: string | null\n}\n\n// ============================================================================\n// Project Types\n// ============================================================================\n\nexport interface LinearProject {\n  id: string\n  name: string\n  color: string\n}\n\n// ============================================================================\n// State Types\n// ============================================================================\n\nexport type LinearStateType =\n  | 'backlog'\n  | 'unstarted'\n  | 'started'\n  | 'completed'\n  | 'canceled'\n\nexport interface LinearState {\n  id: string\n  name: string\n  color: string\n  type: LinearStateType\n}\n\n// ============================================================================\n// Issue Types\n// ============================================================================\n\nexport type LinearPriority = 0 | 1 | 2 | 3 | 4\n\nexport const LINEAR_PRIORITY_LABELS: Record<LinearPriority, string> = {\n  0: 'No priority',\n  1: 'Urgent',\n  2: 'High',\n  3: 'Medium',\n  4: 'Low',\n}\n\nexport interface LinearIssue {\n  id: string\n  identifier: string\n  title: string\n  description: string | null\n  priority: LinearPriority\n  priorityLabel: string\n  dueDate: string | null\n  url: string\n  state: LinearState | null\n  project: LinearProject | null\n  createdAt: string\n  updatedAt: string\n}\n\n// ============================================================================\n// Query Types\n// ============================================================================\n\nexport interface IssueQueryOptions {\n  projectId?: string\n  search?: string\n  cursor?: string\n  limit?: number\n}\n\nexport interface PaginatedIssues {\n  issues: LinearIssue[]\n  hasNextPage: boolean\n  endCursor: string | null\n  totalCount: number\n}\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACmDO,IAAM,yBAAyD;AAAA,EACpE,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;","names":[]}

package/dist/types/index.mjs

@@ -0,0 +1,12 @@
+// src/types/linear.ts
+var LINEAR_PRIORITY_LABELS = {
+  0: "No priority",
+  1: "Urgent",
+  2: "High",
+  3: "Medium",
+  4: "Low"
+};
+export {
+  LINEAR_PRIORITY_LABELS
+};
+//# sourceMappingURL=index.mjs.map

package/dist/types/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/linear.ts"],"sourcesContent":["/**\n * Linear API Types\n *\n * Types for interacting with Linear's GraphQL API.\n */\n\n// ============================================================================\n// User Types\n// ============================================================================\n\nexport interface LinearUser {\n  id: string\n  name: string\n  email: string\n  avatarUrl: string | null\n}\n\n// ============================================================================\n// Project Types\n// ============================================================================\n\nexport interface LinearProject {\n  id: string\n  name: string\n  color: string\n}\n\n// ============================================================================\n// State Types\n// ============================================================================\n\nexport type LinearStateType =\n  | 'backlog'\n  | 'unstarted'\n  | 'started'\n  | 'completed'\n  | 'canceled'\n\nexport interface LinearState {\n  id: string\n  name: string\n  color: string\n  type: LinearStateType\n}\n\n// ============================================================================\n// Issue Types\n// ============================================================================\n\nexport type LinearPriority = 0 | 1 | 2 | 3 | 4\n\nexport const LINEAR_PRIORITY_LABELS: Record<LinearPriority, string> = {\n  0: 'No priority',\n  1: 'Urgent',\n  2: 'High',\n  3: 'Medium',\n  4: 'Low',\n}\n\nexport interface LinearIssue {\n  id: string\n  identifier: string\n  title: string\n  description: string | null\n  priority: LinearPriority\n  priorityLabel: string\n  dueDate: string | null\n  url: string\n  state: LinearState | null\n  project: LinearProject | null\n  createdAt: string\n  updatedAt: string\n}\n\n// ============================================================================\n// Query Types\n// ============================================================================\n\nexport interface IssueQueryOptions {\n  projectId?: string\n  search?: string\n  cursor?: string\n  limit?: number\n}\n\nexport interface PaginatedIssues {\n  issues: LinearIssue[]\n  hasNextPage: boolean\n  endCursor: string | null\n  totalCount: number\n}\n\n"],"mappings":";AAmDO,IAAM,yBAAyD;AAAA,EACpE,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;","names":[]}

package/dist/utils/index.d.mts

@@ -0,0 +1,159 @@
+import { a as Expense, d as Income } from '../database-BKc0Oj26.mjs';
+import { Frequency } from '../constants/index.mjs';
+
+/**
+ * Formatting Utilities
+ *
+ * Pure functions for formatting data.
+ */
+/**
+ * Format seconds into MM:SS format
+ * @example formatTime(125) => "02:05"
+ */
+declare function formatTime(seconds: number): string;
+/**
+ * Format seconds into human-readable total time
+ * @example formatTotalTime(3700) => "1h 1m"
+ * @example formatTotalTime(1800) => "30m"
+ */
+declare function formatTotalTime(seconds: number): string;
+/**
+ * Format a number as currency
+ * @example formatCurrency(1234.56, 'CHF') => "CHF 1,234.56"
+ */
+declare function formatCurrency(amount: number, currency: string, locale?: string): string;
+/**
+ * Format a date as relative time (e.g., "2h ago", "3d ago")
+ */
+declare function formatRelativeTime(dateStr: string): string;
+/**
+ * Format a date string to a readable format
+ * @example formatDate('2024-01-15') => "Jan 15, 2024"
+ */
+declare function formatDate(dateStr: string, options?: Intl.DateTimeFormatOptions): string;
+/**
+ * Format a due date with context (Today, Tomorrow, Overdue, etc.)
+ */
+declare function formatDueDate(dueDate: string | null): {
+    text: string;
+    isOverdue: boolean;
+};
+/**
+ * Truncate a string with ellipsis
+ * @example truncate("Hello World", 5) => "Hello..."
+ */
+declare function truncate(str: string, maxLength: number): string;
+/**
+ * Extract repo name from GitHub URL
+ * @example getRepoName("https://github.com/owner/repo") => "owner/repo"
+ */
+declare function getRepoName(url: string): string;
+
+/**
+ * ID and Data Generators
+ *
+ * Pure functions for generating IDs and data.
+ */
+/**
+ * Generate a unique ID
+ * Uses crypto.randomUUID if available, falls back to timestamp-based ID
+ *
+ * Note: This works in both Node.js and browser environments.
+ * React Native needs the fallback since crypto.randomUUID isn't available.
+ */
+declare function generateId(): string;
+/**
+ * Generate a short ID (timestamp + random)
+ * Format: {timestamp}-{random7chars}
+ * @example "1732547123456-k8f3j2m"
+ */
+declare function generateShortId(): string;
+/**
+ * Generate a random color in hex format
+ */
+declare function generateRandomColor(): string;
+
+/**
+ * Validation Utilities
+ *
+ * Pure functions for validating data.
+ */
+/**
+ * Check if a string is a valid email
+ */
+declare function isValidEmail(email: string): boolean;
+/**
+ * Check if a string is a valid URL
+ */
+declare function isValidUrl(url: string): boolean;
+/**
+ * Check if a string is a valid ISO date (YYYY-MM-DD)
+ */
+declare function isValidISODate(dateStr: string): boolean;
+/**
+ * Check if a value is a valid currency code
+ */
+declare function isValidCurrency(currency: string): boolean;
+/**
+ * Check if a value is a valid frequency
+ */
+declare function isValidFrequency(frequency: string): boolean;
+/**
+ * Validate a positive number
+ */
+declare function isPositiveNumber(value: unknown): value is number;
+/**
+ * Validate a non-empty string
+ */
+declare function isNonEmptyString(value: unknown): value is string;
+
+/**
+ * Calculation Utilities
+ *
+ * Pure functions for business logic calculations.
+ */
+
+/**
+ * Convert an amount to yearly based on frequency
+ */
+declare function toYearlyAmount(amount: number, frequency: Frequency): number;
+/**
+ * Convert an amount to monthly based on frequency
+ */
+declare function toMonthlyAmount(amount: number, frequency: Frequency): number;
+/**
+ * Calculate total expenses (monthly)
+ */
+declare function calculateMonthlyExpenses(expenses: Expense[]): number;
+/**
+ * Calculate total income (monthly)
+ */
+declare function calculateMonthlyIncome(incomes: Income[]): number;
+/**
+ * Calculate savings (income - expenses)
+ */
+declare function calculateMonthlySavings(incomes: Income[], expenses: Expense[]): number;
+/**
+ * Calculate savings rate as percentage
+ */
+declare function calculateSavingsRate(incomes: Income[], expenses: Expense[]): number;
+/**
+ * Calculate lieu day balance
+ */
+declare function calculateLieuBalance(lieuDays: Array<{
+    type: 'earned' | 'used';
+}>): number;
+/**
+ * Calculate focus time stats for a period
+ */
+declare function calculateFocusStats(sessions: Array<{
+    actualSeconds: number;
+    status: string;
+}>): {
+    totalSeconds: number;
+    completedCount: number;
+    abandonedCount: number;
+    completionRate: number;
+};
+
+export { calculateFocusStats, calculateLieuBalance, calculateMonthlyExpenses, calculateMonthlyIncome, calculateMonthlySavings, calculateSavingsRate, formatCurrency, formatDate, formatDueDate, formatRelativeTime, formatTime, formatTotalTime, generateId, generateRandomColor, generateShortId, getRepoName, isNonEmptyString, isPositiveNumber, isValidCurrency, isValidEmail, isValidFrequency, isValidISODate, isValidUrl, toMonthlyAmount, toYearlyAmount, truncate };

package/dist/utils/index.d.ts

@@ -0,0 +1,159 @@
+import { a as Expense, d as Income } from '../database-BKc0Oj26.js';
+import { Frequency } from '../constants/index.js';
+
+/**
+ * Formatting Utilities
+ *
+ * Pure functions for formatting data.
+ */
+/**
+ * Format seconds into MM:SS format
+ * @example formatTime(125) => "02:05"
+ */
+declare function formatTime(seconds: number): string;
+/**
+ * Format seconds into human-readable total time
+ * @example formatTotalTime(3700) => "1h 1m"
+ * @example formatTotalTime(1800) => "30m"
+ */
+declare function formatTotalTime(seconds: number): string;
+/**
+ * Format a number as currency
+ * @example formatCurrency(1234.56, 'CHF') => "CHF 1,234.56"
+ */
+declare function formatCurrency(amount: number, currency: string, locale?: string): string;
+/**
+ * Format a date as relative time (e.g., "2h ago", "3d ago")
+ */
+declare function formatRelativeTime(dateStr: string): string;
+/**
+ * Format a date string to a readable format
+ * @example formatDate('2024-01-15') => "Jan 15, 2024"
+ */
+declare function formatDate(dateStr: string, options?: Intl.DateTimeFormatOptions): string;
+/**
+ * Format a due date with context (Today, Tomorrow, Overdue, etc.)
+ */
+declare function formatDueDate(dueDate: string | null): {
+    text: string;
+    isOverdue: boolean;
+};
+/**
+ * Truncate a string with ellipsis
+ * @example truncate("Hello World", 5) => "Hello..."
+ */
+declare function truncate(str: string, maxLength: number): string;
+/**
+ * Extract repo name from GitHub URL
+ * @example getRepoName("https://github.com/owner/repo") => "owner/repo"
+ */
+declare function getRepoName(url: string): string;
+
+/**
+ * ID and Data Generators
+ *
+ * Pure functions for generating IDs and data.
+ */
+/**
+ * Generate a unique ID
+ * Uses crypto.randomUUID if available, falls back to timestamp-based ID
+ *
+ * Note: This works in both Node.js and browser environments.
+ * React Native needs the fallback since crypto.randomUUID isn't available.
+ */
+declare function generateId(): string;
+/**
+ * Generate a short ID (timestamp + random)
+ * Format: {timestamp}-{random7chars}
+ * @example "1732547123456-k8f3j2m"
+ */
+declare function generateShortId(): string;
+/**
+ * Generate a random color in hex format
+ */
+declare function generateRandomColor(): string;
+
+/**
+ * Validation Utilities
+ *
+ * Pure functions for validating data.
+ */
+/**
+ * Check if a string is a valid email
+ */
+declare function isValidEmail(email: string): boolean;
+/**
+ * Check if a string is a valid URL
+ */
+declare function isValidUrl(url: string): boolean;
+/**
+ * Check if a string is a valid ISO date (YYYY-MM-DD)
+ */
+declare function isValidISODate(dateStr: string): boolean;
+/**
+ * Check if a value is a valid currency code
+ */
+declare function isValidCurrency(currency: string): boolean;
+/**
+ * Check if a value is a valid frequency
+ */
+declare function isValidFrequency(frequency: string): boolean;
+/**
+ * Validate a positive number
+ */
+declare function isPositiveNumber(value: unknown): value is number;
+/**
+ * Validate a non-empty string
+ */
+declare function isNonEmptyString(value: unknown): value is string;
+
+/**
+ * Calculation Utilities
+ *
+ * Pure functions for business logic calculations.
+ */
+
+/**
+ * Convert an amount to yearly based on frequency
+ */
+declare function toYearlyAmount(amount: number, frequency: Frequency): number;
+/**
+ * Convert an amount to monthly based on frequency
+ */
+declare function toMonthlyAmount(amount: number, frequency: Frequency): number;
+/**
+ * Calculate total expenses (monthly)
+ */
+declare function calculateMonthlyExpenses(expenses: Expense[]): number;
+/**
+ * Calculate total income (monthly)
+ */
+declare function calculateMonthlyIncome(incomes: Income[]): number;
+/**
+ * Calculate savings (income - expenses)
+ */
+declare function calculateMonthlySavings(incomes: Income[], expenses: Expense[]): number;
+/**
+ * Calculate savings rate as percentage
+ */
+declare function calculateSavingsRate(incomes: Income[], expenses: Expense[]): number;
+/**
+ * Calculate lieu day balance
+ */
+declare function calculateLieuBalance(lieuDays: Array<{
+    type: 'earned' | 'used';
+}>): number;
+/**
+ * Calculate focus time stats for a period
+ */
+declare function calculateFocusStats(sessions: Array<{
+    actualSeconds: number;
+    status: string;
+}>): {
+    totalSeconds: number;
+    completedCount: number;
+    abandonedCount: number;
+    completionRate: number;
+};
+
+export { calculateFocusStats, calculateLieuBalance, calculateMonthlyExpenses, calculateMonthlyIncome, calculateMonthlySavings, calculateSavingsRate, formatCurrency, formatDate, formatDueDate, formatRelativeTime, formatTime, formatTotalTime, generateId, generateRandomColor, generateShortId, getRepoName, isNonEmptyString, isPositiveNumber, isValidCurrency, isValidEmail, isValidFrequency, isValidISODate, isValidUrl, toMonthlyAmount, toYearlyAmount, truncate };