@task-mcp/shared 1.0.4 → 1.0.7

package/dist/utils/hierarchy.d.ts

@@ -0,0 +1,75 @@
+import type { Task } from "../schemas/task.js";
+/**
+ * Maximum allowed hierarchy depth (0-indexed)
+ * 0 = root task
+ * 1 = subtask
+ * 2 = sub-subtask
+ * 3 = sub-sub-subtask (maximum)
+ */
+export declare const MAX_HIERARCHY_DEPTH = 3;
+/**
+ * Calculates the hierarchy level of a task.
+ * Level 0 = root task (no parent)
+ * Level 1 = direct subtask
+ * Level 2 = sub-subtask
+ * etc.
+ *
+ * @param tasks - Array of all tasks
+ * @param taskId - ID of the task to get level for
+ * @returns The hierarchy level (0 for root), or -1 if task not found
+ */
+export declare function getTaskLevel(tasks: Task[], taskId: string): number;
+/**
+ * Validates whether adding a child task under the given parent
+ * would exceed the maximum hierarchy depth.
+ *
+ * @param tasks - Array of all tasks
+ * @param parentId - ID of the proposed parent task
+ * @returns true if a child can be added, false if it would exceed max depth
+ */
+export declare function validateHierarchyDepth(tasks: Task[], parentId: string): boolean;
+/**
+ * Gets all ancestor task IDs for a given task (from immediate parent to root).
+ *
+ * @param tasks - Array of all tasks
+ * @param taskId - ID of the task
+ * @returns Array of ancestor task IDs, ordered from immediate parent to root
+ */
+export declare function getAncestorIds(tasks: Task[], taskId: string): string[];
+/**
+ * Gets all descendant task IDs for a given task (children, grandchildren, etc.).
+ *
+ * @param tasks - Array of all tasks
+ * @param taskId - ID of the parent task
+ * @returns Array of descendant task IDs
+ */
+export declare function getDescendantIds(tasks: Task[], taskId: string): string[];
+/**
+ * Gets direct children of a task.
+ *
+ * @param tasks - Array of all tasks
+ * @param taskId - ID of the parent task
+ * @returns Array of direct child tasks
+ */
+export declare function getChildTasks(tasks: Task[], taskId: string): Task[];
+/**
+ * Gets the root task of a hierarchy.
+ *
+ * @param tasks - Array of all tasks
+ * @param taskId - ID of any task in the hierarchy
+ * @returns The root task, or null if not found
+ */
+export declare function getRootTask(tasks: Task[], taskId: string): Task | null;
+/**
+ * Builds a tree structure from flat task list.
+ *
+ * @param tasks - Array of all tasks
+ * @param rootId - Optional root task ID (if not provided, returns all root tasks)
+ * @returns Tree structure with children arrays
+ */
+export interface TaskTreeNode {
+    task: Task;
+    children: TaskTreeNode[];
+}
+export declare function buildTaskTree(tasks: Task[], rootId?: string): TaskTreeNode[];
+//# sourceMappingURL=hierarchy.d.ts.map

package/dist/utils/hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../src/utils/hierarchy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA0BlE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,EAAE,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAUT;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BtE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBxE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAiBtE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAgC5E"}

package/dist/utils/hierarchy.js

@@ -0,0 +1,179 @@
+/**
+ * Maximum allowed hierarchy depth (0-indexed)
+ * 0 = root task
+ * 1 = subtask
+ * 2 = sub-subtask
+ * 3 = sub-sub-subtask (maximum)
+ */
+export const MAX_HIERARCHY_DEPTH = 3;
+/**
+ * Calculates the hierarchy level of a task.
+ * Level 0 = root task (no parent)
+ * Level 1 = direct subtask
+ * Level 2 = sub-subtask
+ * etc.
+ *
+ * @param tasks - Array of all tasks
+ * @param taskId - ID of the task to get level for
+ * @returns The hierarchy level (0 for root), or -1 if task not found
+ */
+export function getTaskLevel(tasks, taskId) {
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    const task = taskMap.get(taskId);
+    if (!task) {
+        return -1;
+    }
+    let level = 0;
+    let currentTask = task;
+    while (currentTask.parentId) {
+        const parent = taskMap.get(currentTask.parentId);
+        if (!parent) {
+            break; // Parent not found, stop traversal
+        }
+        level++;
+        currentTask = parent;
+        // Safety check to prevent infinite loops
+        if (level > MAX_HIERARCHY_DEPTH + 1) {
+            break;
+        }
+    }
+    return level;
+}
+/**
+ * Validates whether adding a child task under the given parent
+ * would exceed the maximum hierarchy depth.
+ *
+ * @param tasks - Array of all tasks
+ * @param parentId - ID of the proposed parent task
+ * @returns true if a child can be added, false if it would exceed max depth
+ */
+export function validateHierarchyDepth(tasks, parentId) {
+    const parentLevel = getTaskLevel(tasks, parentId);
+    if (parentLevel === -1) {
+        return false; // Parent task not found
+    }
+    // Child would be at parentLevel + 1
+    // If parent is at level 3, child would be at level 4 which exceeds max
+    return parentLevel < MAX_HIERARCHY_DEPTH;
+}
+/**
+ * Gets all ancestor task IDs for a given task (from immediate parent to root).
+ *
+ * @param tasks - Array of all tasks
+ * @param taskId - ID of the task
+ * @returns Array of ancestor task IDs, ordered from immediate parent to root
+ */
+export function getAncestorIds(tasks, taskId) {
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    const task = taskMap.get(taskId);
+    if (!task) {
+        return [];
+    }
+    const ancestors = [];
+    let currentTask = task;
+    while (currentTask.parentId) {
+        ancestors.push(currentTask.parentId);
+        const parent = taskMap.get(currentTask.parentId);
+        if (!parent) {
+            break;
+        }
+        currentTask = parent;
+        // Safety check
+        if (ancestors.length > MAX_HIERARCHY_DEPTH + 1) {
+            break;
+        }
+    }
+    return ancestors;
+}
+/**
+ * Gets all descendant task IDs for a given task (children, grandchildren, etc.).
+ *
+ * @param tasks - Array of all tasks
+ * @param taskId - ID of the parent task
+ * @returns Array of descendant task IDs
+ */
+export function getDescendantIds(tasks, taskId) {
+    const descendants = [];
+    const childrenMap = new Map();
+    // Build parent -> children map
+    for (const task of tasks) {
+        if (task.parentId) {
+            const children = childrenMap.get(task.parentId) || [];
+            children.push(task);
+            childrenMap.set(task.parentId, children);
+        }
+    }
+    // BFS to collect all descendants
+    const queue = [taskId];
+    while (queue.length > 0) {
+        const currentId = queue.shift();
+        const children = childrenMap.get(currentId) || [];
+        for (const child of children) {
+            descendants.push(child.id);
+            queue.push(child.id);
+        }
+    }
+    return descendants;
+}
+/**
+ * Gets direct children of a task.
+ *
+ * @param tasks - Array of all tasks
+ * @param taskId - ID of the parent task
+ * @returns Array of direct child tasks
+ */
+export function getChildTasks(tasks, taskId) {
+    return tasks.filter((t) => t.parentId === taskId);
+}
+/**
+ * Gets the root task of a hierarchy.
+ *
+ * @param tasks - Array of all tasks
+ * @param taskId - ID of any task in the hierarchy
+ * @returns The root task, or null if not found
+ */
+export function getRootTask(tasks, taskId) {
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    let currentTask = taskMap.get(taskId);
+    if (!currentTask) {
+        return null;
+    }
+    while (currentTask.parentId) {
+        const parent = taskMap.get(currentTask.parentId);
+        if (!parent) {
+            break;
+        }
+        currentTask = parent;
+    }
+    return currentTask;
+}
+export function buildTaskTree(tasks, rootId) {
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    const childrenMap = new Map();
+    // Build parent -> children map
+    for (const task of tasks) {
+        if (task.parentId) {
+            const children = childrenMap.get(task.parentId) || [];
+            children.push(task);
+            childrenMap.set(task.parentId, children);
+        }
+    }
+    function buildNode(task) {
+        const children = childrenMap.get(task.id) || [];
+        return {
+            task,
+            children: children.map(buildNode),
+        };
+    }
+    if (rootId) {
+        const rootTask = taskMap.get(rootId);
+        if (!rootTask) {
+            return [];
+        }
+        return [buildNode(rootTask)];
+    }
+    // Return all root tasks (no parent)
+    const rootTasks = tasks.filter((t) => !t.parentId);
+    return rootTasks.map(buildNode);
+}
+//# sourceMappingURL=hierarchy.js.map

package/dist/utils/hierarchy.js.map

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

package/dist/utils/id.d.ts

@@ -1,5 +1,6 @@
 /**
- * Generate a unique ID with optional prefix
+ * Generate a unique ID with optional prefix.
+ * Uses crypto.randomUUID for secure, collision-resistant ID generation.
  */
 export declare function generateId(prefix?: string): string;
 /**
@@ -24,4 +25,53 @@ export declare function isValidProjectId(id: string): boolean;
  * @returns true if valid format (task_[alphanumeric])
  */
 export declare function isValidTaskId(id: string): boolean;
+/**
+ * Generate an inbox item ID
+ */
+export declare function generateInboxId(): string;
+/**
+ * Validate an inbox ID format
+ * @returns true if valid format (inbox_[alphanumeric])
+ */
+export declare function isValidInboxId(id: string): boolean;
+/**
+ * ID validation error with detailed context
+ */
+export declare class InvalidIdError extends Error {
+    readonly idType: "task" | "project" | "inbox" | "view";
+    readonly invalidValue: unknown;
+    readonly reason: string;
+    constructor(idType: "task" | "project" | "inbox" | "view", invalidValue: unknown, reason: string);
+}
+/**
+ * Validation result with reason if invalid
+ */
+export interface IdValidationResult {
+    valid: boolean;
+    reason?: string;
+}
+/**
+ * Validate task ID with detailed error information
+ */
+export declare function validateTaskId(id: unknown): IdValidationResult;
+/**
+ * Validate project ID with detailed error information
+ */
+export declare function validateProjectId(id: unknown): IdValidationResult;
+/**
+ * Validate inbox ID with detailed error information
+ */
+export declare function validateInboxId(id: unknown): IdValidationResult;
+/**
+ * Assert valid task ID, throw if invalid
+ */
+export declare function assertValidTaskId(id: unknown): asserts id is string;
+/**
+ * Assert valid project ID, throw if invalid
+ */
+export declare function assertValidProjectId(id: unknown): asserts id is string;
+/**
+ * Assert valid inbox ID, throw if invalid
+ */
+export declare function assertValidInboxId(id: unknown): asserts id is string;
 //# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM,CAItD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD"}
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM,CAKtD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAErB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM;aAC7C,YAAY,EAAE,OAAO;aACrB,MAAM,EAAE,MAAM;gBAFd,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,EAC7C,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE,MAAM;CAKjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,kBAAkB,CAiB9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,GAAG,kBAAkB,CAiBjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,kBAAkB,CAiB/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,IAAI,MAAM,CAKnE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,IAAI,MAAM,CAKtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,IAAI,MAAM,CAKpE"}

package/dist/utils/id.js

@@ -1,10 +1,12 @@
 /**
- * Generate a unique ID with optional prefix
+ * Generate a unique ID with optional prefix.
+ * Uses crypto.randomUUID for secure, collision-resistant ID generation.
  */
 export function generateId(prefix = "") {
-    const timestamp = Date.now().toString(36);
-    const random = Math.random().toString(36).substring(2, 8);
-    return prefix ? `${prefix}_${timestamp}${random}` : `${timestamp}${random}`;
+    // Use crypto.randomUUID for better randomness and collision resistance
+    // Format: prefix_xxxxxxxx (8 chars from UUID, sufficient for local uniqueness)
+    const uuid = crypto.randomUUID().replace(/-/g, "").slice(0, 12);
+    return prefix ? `${prefix}_${uuid}` : uuid;
 }
 /**
  * Generate a task ID
@@ -38,4 +40,122 @@ export function isValidProjectId(id) {
 export function isValidTaskId(id) {
     return /^task_[a-z0-9]+$/.test(id);
 }
+/**
+ * Generate an inbox item ID
+ */
+export function generateInboxId() {
+    return generateId("inbox");
+}
+/**
+ * Validate an inbox ID format
+ * @returns true if valid format (inbox_[alphanumeric])
+ */
+export function isValidInboxId(id) {
+    return /^inbox_[a-z0-9]+$/.test(id);
+}
+/**
+ * ID validation error with detailed context
+ */
+export class InvalidIdError extends Error {
+    idType;
+    invalidValue;
+    reason;
+    constructor(idType, invalidValue, reason) {
+        super(`Invalid ${idType} ID: ${reason}`);
+        this.idType = idType;
+        this.invalidValue = invalidValue;
+        this.reason = reason;
+        this.name = "InvalidIdError";
+    }
+}
+/**
+ * Validate task ID with detailed error information
+ */
+export function validateTaskId(id) {
+    if (id === null || id === undefined) {
+        return { valid: false, reason: "Task ID is required" };
+    }
+    if (typeof id !== "string") {
+        return { valid: false, reason: `Task ID must be a string (received ${typeof id})` };
+    }
+    if (id.length === 0) {
+        return { valid: false, reason: "Task ID cannot be empty" };
+    }
+    if (!id.startsWith("task_")) {
+        return { valid: false, reason: "Task ID must start with 'task_' prefix" };
+    }
+    if (!/^task_[a-z0-9]+$/.test(id)) {
+        return { valid: false, reason: "Task ID contains invalid characters" };
+    }
+    return { valid: true };
+}
+/**
+ * Validate project ID with detailed error information
+ */
+export function validateProjectId(id) {
+    if (id === null || id === undefined) {
+        return { valid: false, reason: "Project ID is required" };
+    }
+    if (typeof id !== "string") {
+        return { valid: false, reason: `Project ID must be a string (received ${typeof id})` };
+    }
+    if (id.length === 0) {
+        return { valid: false, reason: "Project ID cannot be empty" };
+    }
+    if (!id.startsWith("proj_")) {
+        return { valid: false, reason: "Project ID must start with 'proj_' prefix" };
+    }
+    if (!/^proj_[a-z0-9]+$/.test(id)) {
+        return { valid: false, reason: "Project ID contains invalid characters" };
+    }
+    return { valid: true };
+}
+/**
+ * Validate inbox ID with detailed error information
+ */
+export function validateInboxId(id) {
+    if (id === null || id === undefined) {
+        return { valid: false, reason: "Inbox ID is required" };
+    }
+    if (typeof id !== "string") {
+        return { valid: false, reason: `Inbox ID must be a string (received ${typeof id})` };
+    }
+    if (id.length === 0) {
+        return { valid: false, reason: "Inbox ID cannot be empty" };
+    }
+    if (!id.startsWith("inbox_")) {
+        return { valid: false, reason: "Inbox ID must start with 'inbox_' prefix" };
+    }
+    if (!/^inbox_[a-z0-9]+$/.test(id)) {
+        return { valid: false, reason: "Inbox ID contains invalid characters" };
+    }
+    return { valid: true };
+}
+/**
+ * Assert valid task ID, throw if invalid
+ */
+export function assertValidTaskId(id) {
+    const result = validateTaskId(id);
+    if (!result.valid) {
+        throw new InvalidIdError("task", id, result.reason);
+    }
+}
+/**
+ * Assert valid project ID, throw if invalid
+ */
+export function assertValidProjectId(id) {
+    const result = validateProjectId(id);
+    if (!result.valid) {
+        throw new InvalidIdError("project", id, result.reason);
+    }
+}
+/**
+ * Assert valid inbox ID, throw if invalid
+ */
+export function assertValidInboxId(id) {
+    const result = validateInboxId(id);
+    if (!result.valid) {
+        throw new InvalidIdError("inbox", id, result.reason);
+    }
+}
 //# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -1 +1 @@
-{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,SAAS,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,MAAM,EAAE,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"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"}

package/dist/utils/id.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=id.test.d.ts.map

package/dist/utils/id.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.test.d.ts","sourceRoot":"","sources":["../../src/utils/id.test.ts"],"names":[],"mappings":""}