@baack-software/baack-ts-tasks 0.0.0-stage → 0.0.1

package/dist/task-client.js

@@ -0,0 +1,271 @@
+import { Endpoint, isBaackApiError, } from '@baack-software/baack-ts-client';
+import { draft as makeDraft, isEmptyChange, updateBody, validateTask } from "./draft.js";
+import { changedFields, fieldsChanged, findConflicts, rebaseLists } from "./conflicts.js";
+import { TaskConflictError, TaskSearchTimeoutError, TaskValidationError } from "./errors.js";
+import { ref, urnOf, withRef, withoutRef } from "./refs.js";
+import { TASK_LIST_FIELDS } from "./types.js";
+/**
+ * Typed access to Baack tasks and their activity logs, on top of a `BaackClient` that holds the base URL and
+ * credentials.
+ *
+ * ```ts
+ * const tasks = new TaskClient(new BaackClient({ baseUrl: 'https://api.baack.co', credentials: 'include' }));
+ * const { tasks: all } = await tasks.list({ owner: companyUrn });
+ * await tasks.setStatus(all[0], 'IN_PROGRESS', { actor: me });
+ * ```
+ */
+export class TaskClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    // ==========================================
+    // TASKS
+    // ==========================================
+    async get(task) {
+        return this.client.read(Endpoint.TASK, urnOf(task));
+    }
+    /** Reads a workflow: its name and its stages, which tasks move through. */
+    async getWorkflow(workflow) {
+        return this.client.read(Endpoint.WORKFLOW, urnOf(workflow));
+    }
+    /**
+     * Creates a task. Accepts a full `TaskDraft`, or the owner and title plus any other fields, which `draft` fills in.
+     * Throws `TaskValidationError` before sending when the task breaks the API's rules.
+     */
+    async create(input, options = {}) {
+        const body = withActor(makeDraft(input), options);
+        const issues = validateTask(body, { creating: true });
+        if (issues.length > 0)
+            throw new TaskValidationError(issues);
+        return this.client.create(Endpoint.TASK, body);
+    }
+    /**
+     * Changes the task. The API stores the task as an update sends it, clearing optional fields left out, so this reads
+     * the task, applies `changes` and sends it whole (see `updateBody`). Lists are sent whole and the server applies the
+     * difference. Updates to the same task from this client run one at a time, so each builds on the last.
+     *
+     * `changes` can be a function of the task as just read, for changes built from its current state, such as adding
+     * to a list.
+     *
+     * Throws `TaskValidationError` before sending when the changes break the API's rules. Returns the task as the
+     * server has it after the change.
+     *
+     * The `BaackClient`'s `failureGuard` applies: retrying a failed update before its backoff has passed fails at once
+     * with the same error, sending nothing.
+     */
+    async update(task, changes, options = {}) {
+        const urn = urnOf(task);
+        const { base, onChangedElsewhere, ...change } = options;
+        if (typeof changes !== 'function') {
+            check(changes, urn);
+            if (isEmptyChange(changes) && typeof task !== 'string' && isTask(task))
+                return task;
+        }
+        return this.#inTurn(urn, async () => {
+            const current = await this.get(urn);
+            let changed = typeof changes === 'function' ? changes(current) : changes;
+            if (typeof changes === 'function')
+                check(changed, urn);
+            if (base) {
+                // Reported even when the update then stops on a conflict, since the person sees the task as it is now.
+                const touched = new Set([...fieldsChanged(changed), ...TASK_LIST_FIELDS.filter((f) => changed[f] !== undefined)]);
+                const elsewhere = changedFields(base, current).filter((field) => !touched.has(field));
+                if (elsewhere.length > 0)
+                    onChangedElsewhere?.(elsewhere, current);
+                const conflicts = findConflicts(base, current, changed);
+                if (conflicts.length > 0)
+                    throw new TaskConflictError(conflicts, current);
+                changed = rebaseLists(base, current, changed);
+            }
+            return this.client.update(Endpoint.TASK, urn, withActor(updateBody(current, changed), change));
+        });
+    }
+    /** Updates waiting or running, by task URN. */
+    #turns = new Map();
+    /** Runs `work` after the task's earlier updates settle, whether they succeeded or not. */
+    #inTurn(urn, work) {
+        const result = (this.#turns.get(urn) ?? Promise.resolve()).catch(() => undefined).then(work);
+        this.#turns.set(urn, result);
+        const forget = () => {
+            if (this.#turns.get(urn) === result)
+                this.#turns.delete(urn);
+        };
+        result.then(forget, forget);
+        return result;
+    }
+    async delete(task) {
+        await this.client.delete(Endpoint.TASK, urnOf(task));
+    }
+    setStatus(task, status, options) {
+        return this.update(task, { status }, options);
+    }
+    setPriority(task, priority, options) {
+        return this.update(task, { priority }, options);
+    }
+    /** Assigns the task to `assignee`, or unassigns it with `null`. */
+    assign(task, assignee, options) {
+        return this.update(task, { assignee: assignee === null ? null : ref(assignee) }, options);
+    }
+    /** Sets the due date (a Baack timestamp, see `toTimestamp`), or removes it with `null`. */
+    setDue(task, dueTimestamp, options) {
+        return this.update(task, { dueTimestamp }, options);
+    }
+    /** Moves the task into `project`, or out of its project with `null`. */
+    setProject(task, project, options) {
+        return this.update(task, { project: project === null ? null : ref(project) }, options);
+    }
+    /** Moves the task to a workflow stage, or out of its stage with `null`. */
+    setWorkflowStage(task, stage, options) {
+        return this.update(task, { workflowStage: stage === null ? null : ref(stage) }, options);
+    }
+    /** Marks `blocker` as blocking `task`. */
+    addBlocker(task, blocker, options) {
+        return this.addTo(task, 'blockedBy', blocker, options);
+    }
+    removeBlocker(task, blocker, options) {
+        return this.removeFrom(task, 'blockedBy', blocker, options);
+    }
+    /** Adds a reference to one of the task's lists, as the server has the list when the update is sent. */
+    addTo(task, field, value, options) {
+        return this.update(task, (current) => ({ [field]: withRef(current[field], value) }), options);
+    }
+    /** Removes a reference from one of the task's lists, as the server has the list when the update is sent. */
+    removeFrom(task, field, value, options) {
+        return this.update(task, (current) => ({ [field]: withoutRef(current[field], value) }), options);
+    }
+    // ==========================================
+    // ACTIVITY LOG
+    // ==========================================
+    /** One page of the task's activity log, newest first. Pass `pagination.after` from a page to read the next. */
+    async logs(task, options = {}) {
+        const page = await this.client.read(Endpoint.TASK_LOGS, urnOf(task), {
+            after: options.after,
+        });
+        return { logs: page?.logs ?? [], pagination: page?.pagination ?? null };
+    }
+    /** The task's activity log across pages, newest first, stopping after `limit` entries when given. */
+    async allLogs(task, options = {}) {
+        const { limit = Number.POSITIVE_INFINITY } = options;
+        const logs = [];
+        let after;
+        do {
+            const page = await this.logs(task, after === undefined ? {} : { after });
+            logs.push(...page.logs);
+            after = page.pagination?.isMorePages ? (page.pagination.after ?? undefined) : undefined;
+        } while (after !== undefined && logs.length < limit);
+        return logs.slice(0, limit);
+    }
+    /** Adds a comment to the task's activity log. */
+    async comment(task, comment, options = {}) {
+        const body = { task: ref(task), activity: 'COMMENT_ADDED', comment };
+        if (options.actor !== undefined)
+            body['identity'] = ref(options.actor);
+        if (options.replyTo !== undefined)
+            body['replyTo'] = ref(options.replyTo);
+        return this.client.create(Endpoint.TASK_LOG, body);
+    }
+    // ==========================================
+    // LISTING
+    // ==========================================
+    /**
+     * Lists a company's tasks. Runs a search, waits for its full result, follows its pages, then
+     * reads each task (search results don't carry the task itself yet).
+     */
+    async list(options) {
+        const { includeRelated = true, concurrency = 6, signal } = options;
+        const scopes = includeRelated ? ['TASK', 'IDENTITY', 'PROJECT'] : ['TASK'];
+        const items = await this.search({ owner: options.owner, scopes }, { ...(options.poll ?? {}), ...(signal ? { signal } : {}) });
+        const taskItems = items.filter((item) => item.type === 'TASK');
+        const tasks = await mapLimit(taskItems, concurrency, signal, async (item) => {
+            if (item.item && isTask(item.item))
+                return item.item;
+            try {
+                return await this.get(item.urn);
+            }
+            catch (error) {
+                if (isBaackApiError(error) && error.isNotFound)
+                    return undefined;
+                throw error;
+            }
+        });
+        return {
+            tasks: tasks.filter((task) => task !== undefined),
+            identities: items.filter((item) => item.type === 'IDENTITY'),
+            projects: items.filter((item) => item.type === 'PROJECT'),
+        };
+    }
+    /**
+     * Runs a search and returns every item once the result is full, across pages. Exposed for callers that want other
+     * scopes alongside tasks.
+     */
+    async search(query, options = {}) {
+        const { intervalMs = 250, maxIntervalMs = 2000, timeoutMs = 30000, signal } = options;
+        const deadline = Date.now() + timeoutMs;
+        // The API resolves the owner by URN; the client's Company type also wants a url.
+        const body = { owner: ref(query.owner), includeScopes: query.scopes };
+        signal?.throwIfAborted();
+        let search = await this.client.search(body);
+        let wait = intervalMs;
+        while (search.status !== 'FULL_RESULT') {
+            if (!search.urn)
+                throw new Error('The search API returned a search without a URN');
+            if (Date.now() + wait > deadline)
+                throw new TaskSearchTimeoutError(search.urn, timeoutMs);
+            await sleep(wait, signal);
+            search = await this.client.searchResult(search.urn);
+            wait = Math.min(Math.round(wait * 1.5), maxIntervalMs);
+        }
+        const items = [...(search.items ?? [])];
+        let pagination = search.pagination;
+        while (pagination?.isMorePages && pagination.after && search.urn) {
+            signal?.throwIfAborted();
+            const page = await this.client.searchResult(search.urn, pagination.after);
+            items.push(...(page.items ?? []));
+            pagination = page.pagination;
+        }
+        return items;
+    }
+}
+/** Throws `TaskValidationError` when the changes break the API's rules. */
+function check(changes, urn) {
+    const issues = validateTask(changes, { urn });
+    if (issues.length > 0)
+        throw new TaskValidationError(issues);
+}
+function withActor(input, options) {
+    return options.actor === undefined ? input : { ...input, identityForLogs: ref(options.actor) };
+}
+function isTask(value) {
+    return typeof value === 'object' && value !== null && 'urn' in value && 'title' in value && 'status' in value;
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted)
+            return reject(signal.reason);
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason);
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/** Maps `items` with at most `limit` calls running at once, keeping the input order. */
+async function mapLimit(items, limit, signal, fn) {
+    const results = new Array(items.length);
+    let next = 0;
+    const worker = async () => {
+        while (next < items.length) {
+            signal?.throwIfAborted();
+            const index = next++;
+            results[index] = await fn(items[index]);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(Math.max(1, limit), items.length) }, worker));
+    return results;
+}
+//# sourceMappingURL=task-client.js.map

package/dist/task-client.js.map

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

package/dist/tasks.d.ts

@@ -0,0 +1,84 @@
+import type { Task, TaskPriority, TaskStatus, Workflow, WorkflowStage } from '@baack-software/baack-ts-client';
+import type { RefLike } from './types.ts';
+/** Statuses in board order, from not started to done. */
+export declare const TASK_STATUSES: readonly TaskStatus[];
+/** Priorities from lowest to highest. */
+export declare const TASK_PRIORITIES: readonly TaskPriority[];
+export declare const STATUS_LABELS: Readonly<Record<TaskStatus, string>>;
+export declare const PRIORITY_LABELS: Readonly<Record<TaskPriority, string>>;
+/** Whether a status means the work is finished: completed or closed. */
+export declare function isDoneStatus(status: TaskStatus | null | undefined): boolean;
+/** Whether the task still needs work: not completed or closed. */
+export declare function isOpen(task: Pick<Task, 'status'>): boolean;
+/** The task's due date, or undefined when it has none. */
+export declare function dueDate(task: Pick<Task, 'dueTimestamp'>): Date | undefined;
+/** Whether an open task is past its due date. */
+export declare function isOverdue(task: Pick<Task, 'status' | 'dueTimestamp'>, now?: Date): boolean;
+/** Whether an open task is due within `ms` from now, and not yet overdue. */
+export declare function isDueWithin(task: Pick<Task, 'status' | 'dueTimestamp'>, ms: number, now?: Date): boolean;
+export type TaskComparator = (a: Task, b: Task) => number;
+/** Highest priority first. */
+export declare const byPriority: TaskComparator;
+/** Board order of status. */
+export declare const byStatus: TaskComparator;
+/** Soonest due first; tasks without a due date last. */
+export declare const byDue: TaskComparator;
+/** Most recently updated first. */
+export declare const byUpdated: TaskComparator;
+/** Title, alphabetically. */
+export declare const byTitle: TaskComparator;
+/** Sorts by each comparator in turn, using the next to break ties. */
+export declare function compareBy(...comparators: TaskComparator[]): TaskComparator;
+/** Open tasks before completed and closed ones. */
+export declare const byOpen: TaskComparator;
+/** A sensible default for work lists: open first, then overdue and soonest due, then highest priority. */
+export declare const byUrgency: TaskComparator;
+/** Within a board column: open first, then highest priority, soonest due and title, so ties are stable. */
+export declare const byPriorityThenDue: TaskComparator;
+/**
+ * Criteria for `matchesFilter`. Each criterion left out matches every task; all given criteria must match. For
+ * `assignee`, `project` and `workflowStage`, `null` in the list matches tasks with none set.
+ */
+export interface TaskFilter {
+    status?: readonly TaskStatus[];
+    priority?: readonly TaskPriority[];
+    assignee?: readonly (RefLike | null)[];
+    project?: readonly (RefLike | null)[];
+    workflowStage?: readonly (RefLike | null)[];
+    /** Tasks that block on, are blocking, or are associated with this representation. */
+    relatedTo?: RefLike;
+    /** `true` for open tasks only, `false` for done tasks only. */
+    open?: boolean;
+    /** Only open tasks past their due date. */
+    overdue?: boolean;
+    /** Case-insensitive match against the title and description. */
+    text?: string;
+}
+export declare function matchesFilter(task: Task, filter: TaskFilter, now?: Date): boolean;
+export declare function filterTasks(tasks: readonly Task[], filter: TaskFilter, now?: Date): Task[];
+/** Whether the task refers to `target` in its blockers, blocked tasks or associations. */
+export declare function isRelatedTo(task: Task, target: RefLike): boolean;
+export type TaskGrouping = 'status' | 'priority' | 'assignee' | 'project' | 'workflow' | 'workflowStage';
+/** The key used for tasks without an assignee, project, workflow or workflow stage. */
+export declare const NONE_KEY = "";
+/**
+ * Groups tasks into columns, keyed by status, priority, or the URN of the assignee, project or workflow stage
+ * (`NONE_KEY` when unset). Status and priority groups always contain every value in order, so a board shows empty
+ * columns; priority runs highest first. Other groups appear in order of first use.
+ */
+export declare function groupTasks(tasks: readonly Task[], by: TaskGrouping): Map<string, Task[]>;
+/** A workflow's stages in order. */
+export declare function workflowStages(workflow: Workflow): WorkflowStage[];
+/**
+ * Groups tasks into a workflow's stages, keyed by stage URN, every stage in order even when empty. Tasks in no stage,
+ * or in another workflow's, go under `NONE_KEY`, last, which is left out when empty.
+ */
+export declare function groupByStage(tasks: readonly Task[], workflow: Workflow): Map<string, Task[]>;
+/** The workflow a task is in: the one its stage belongs to, as a task records only its stage. */
+export declare function workflowOf(task: Task, workflows: readonly Workflow[]): Workflow | undefined;
+/**
+ * Groups tasks by workflow, keyed by workflow URN, every workflow in the order given even when empty. Tasks in no
+ * workflow's stage go under `NONE_KEY`, last, which is left out when empty.
+ */
+export declare function groupByWorkflow(tasks: readonly Task[], workflows: readonly Workflow[]): Map<string, Task[]>;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/tasks.d.ts.map

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

package/dist/tasks.js

@@ -0,0 +1,208 @@
+import { urnOf } from "./refs.js";
+import { parseTimestamp } from "./time.js";
+/** Statuses in board order, from not started to done. */
+export const TASK_STATUSES = [
+    'UNDEFINED',
+    'PENDING',
+    'IN_PROGRESS',
+    'BLOCKED',
+    'COMPLETED',
+    'CLOSED',
+];
+/** Priorities from lowest to highest. */
+export const TASK_PRIORITIES = ['NONE', 'LOW', 'MEDIUM', 'HIGH', 'CRITICAL'];
+export const STATUS_LABELS = {
+    UNDEFINED: 'Undefined',
+    PENDING: 'Pending',
+    IN_PROGRESS: 'In progress',
+    BLOCKED: 'Blocked',
+    COMPLETED: 'Completed',
+    CLOSED: 'Closed',
+};
+export const PRIORITY_LABELS = {
+    NONE: 'None',
+    LOW: 'Low',
+    MEDIUM: 'Medium',
+    HIGH: 'High',
+    CRITICAL: 'Critical',
+};
+const DONE = new Set(['COMPLETED', 'CLOSED']);
+/** Whether a status means the work is finished: completed or closed. */
+export function isDoneStatus(status) {
+    return status != null && DONE.has(status);
+}
+/** Whether the task still needs work: not completed or closed. */
+export function isOpen(task) {
+    return !isDoneStatus(task.status);
+}
+/** The task's due date, or undefined when it has none. */
+export function dueDate(task) {
+    return parseTimestamp(task.dueTimestamp);
+}
+/** Whether an open task is past its due date. */
+export function isOverdue(task, now = new Date()) {
+    const due = dueDate(task);
+    return isOpen(task) && due !== undefined && due.getTime() < now.getTime();
+}
+/** Whether an open task is due within `ms` from now, and not yet overdue. */
+export function isDueWithin(task, ms, now = new Date()) {
+    const due = dueDate(task);
+    if (!isOpen(task) || due === undefined)
+        return false;
+    const left = due.getTime() - now.getTime();
+    return left >= 0 && left <= ms;
+}
+/** Highest priority first. */
+export const byPriority = (a, b) => TASK_PRIORITIES.indexOf(b.priority) - TASK_PRIORITIES.indexOf(a.priority);
+/** Board order of status. */
+export const byStatus = (a, b) => TASK_STATUSES.indexOf(a.status) - TASK_STATUSES.indexOf(b.status);
+/** Soonest due first; tasks without a due date last. */
+export const byDue = (a, b) => {
+    const [first, second] = [timeOrInfinity(a.dueTimestamp), timeOrInfinity(b.dueTimestamp)];
+    // Two tasks without due dates tie (Infinity - Infinity is NaN, which would stop the next comparator breaking it).
+    return first === second ? 0 : first - second;
+};
+/** Most recently updated first. */
+export const byUpdated = (a, b) => -(timeOrInfinity(a.updatedTimestamp, 0) - timeOrInfinity(b.updatedTimestamp, 0));
+/** Title, alphabetically. */
+export const byTitle = (a, b) => a.title.localeCompare(b.title);
+/** Sorts by each comparator in turn, using the next to break ties. */
+export function compareBy(...comparators) {
+    return (a, b) => {
+        for (const compare of comparators) {
+            const result = compare(a, b);
+            if (result !== 0)
+                return result;
+        }
+        return 0;
+    };
+}
+/** Open tasks before completed and closed ones. */
+export const byOpen = (a, b) => Number(isOpen(b)) - Number(isOpen(a));
+/** A sensible default for work lists: open first, then overdue and soonest due, then highest priority. */
+export const byUrgency = compareBy(byOpen, byDue, byPriority, byTitle);
+/** Within a board column: open first, then highest priority, soonest due and title, so ties are stable. */
+export const byPriorityThenDue = compareBy(byOpen, byPriority, byDue, byTitle);
+function timeOrInfinity(timestamp, fallback = Number.POSITIVE_INFINITY) {
+    return parseTimestamp(timestamp)?.getTime() ?? fallback;
+}
+export function matchesFilter(task, filter, now = new Date()) {
+    if (filter.status && !filter.status.includes(task.status))
+        return false;
+    if (filter.priority && !filter.priority.includes(task.priority))
+        return false;
+    if (filter.assignee && !matchesRef(task.assignee, filter.assignee))
+        return false;
+    if (filter.project && !matchesRef(task.project, filter.project))
+        return false;
+    if (filter.workflowStage && !matchesRef(task.workflowStage, filter.workflowStage))
+        return false;
+    if (filter.relatedTo !== undefined && !isRelatedTo(task, filter.relatedTo))
+        return false;
+    if (filter.open !== undefined && isOpen(task) !== filter.open)
+        return false;
+    if (filter.overdue && !isOverdue(task, now))
+        return false;
+    if (filter.text) {
+        const needle = filter.text.toLocaleLowerCase();
+        const haystack = `${task.title}\n${task.description}`.toLocaleLowerCase();
+        if (!haystack.includes(needle))
+            return false;
+    }
+    return true;
+}
+export function filterTasks(tasks, filter, now = new Date()) {
+    return tasks.filter((task) => matchesFilter(task, filter, now));
+}
+/** Whether the task refers to `target` in its blockers, blocked tasks or associations. */
+export function isRelatedTo(task, target) {
+    const urn = urnOf(target);
+    const lists = [
+        task.blockedBy,
+        task.blocking,
+        task.associatedTasks,
+        task.associatedEntities,
+        task.associatedIdentities,
+        task.associatedCompanies,
+    ];
+    return lists.some((list) => list?.some((item) => item.urn === urn));
+}
+function matchesRef(value, wanted) {
+    return wanted.some((candidate) => (candidate === null ? value == null : value?.urn === urnOf(candidate)));
+}
+/** The key used for tasks without an assignee, project, workflow or workflow stage. */
+export const NONE_KEY = '';
+/**
+ * Groups tasks into columns, keyed by status, priority, or the URN of the assignee, project or workflow stage
+ * (`NONE_KEY` when unset). Status and priority groups always contain every value in order, so a board shows empty
+ * columns; priority runs highest first. Other groups appear in order of first use.
+ */
+export function groupTasks(tasks, by) {
+    const groups = new Map();
+    if (by === 'status')
+        TASK_STATUSES.forEach((status) => groups.set(status, []));
+    if (by === 'priority')
+        [...TASK_PRIORITIES].reverse().forEach((priority) => groups.set(priority, []));
+    for (const task of tasks) {
+        const key = groupKey(task, by);
+        const group = groups.get(key);
+        if (group)
+            group.push(task);
+        else
+            groups.set(key, [task]);
+    }
+    return groups;
+}
+/** A workflow's stages in order. */
+export function workflowStages(workflow) {
+    return [...(workflow.stages ?? [])].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+}
+/**
+ * Groups tasks into a workflow's stages, keyed by stage URN, every stage in order even when empty. Tasks in no stage,
+ * or in another workflow's, go under `NONE_KEY`, last, which is left out when empty.
+ */
+export function groupByStage(tasks, workflow) {
+    const groups = new Map(workflowStages(workflow).map((stage) => [stage.urn, []]));
+    const rest = [];
+    for (const task of tasks)
+        (groups.get(task.workflowStage?.urn ?? NONE_KEY) ?? rest).push(task);
+    if (rest.length > 0)
+        groups.set(NONE_KEY, rest);
+    return groups;
+}
+/** The workflow a task is in: the one its stage belongs to, as a task records only its stage. */
+export function workflowOf(task, workflows) {
+    const stage = task.workflowStage?.urn;
+    return stage ? workflows.find((workflow) => workflow.stages?.some((s) => s.urn === stage)) : undefined;
+}
+/**
+ * Groups tasks by workflow, keyed by workflow URN, every workflow in the order given even when empty. Tasks in no
+ * workflow's stage go under `NONE_KEY`, last, which is left out when empty.
+ */
+export function groupByWorkflow(tasks, workflows) {
+    const groups = new Map(workflows.map((workflow) => [workflow.urn, []]));
+    const rest = [];
+    for (const task of tasks)
+        (groups.get(workflowOf(task, workflows)?.urn ?? NONE_KEY) ?? rest).push(task);
+    if (rest.length > 0)
+        groups.set(NONE_KEY, rest);
+    return groups;
+}
+function groupKey(task, by) {
+    switch (by) {
+        case 'status':
+            return task.status;
+        case 'priority':
+            return task.priority;
+        case 'assignee':
+            return task.assignee?.urn ?? NONE_KEY;
+        case 'project':
+            return task.project?.urn ?? NONE_KEY;
+        case 'workflowStage':
+            return task.workflowStage?.urn ?? NONE_KEY;
+        // A task's workflow is found from its stage, which needs the workflows: `groupByWorkflow`.
+        case 'workflow':
+            return NONE_KEY;
+    }
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tasks.js.map

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

package/dist/time.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Baack timestamps are ISO 8601 in UTC without a zone, for example `2025-09-13T17:08:00` or `2025-09-13T17:08:00.000`.
+ * A plain `new Date(timestamp)` would read them as local time, so use these helpers instead.
+ */
+/** Reads a Baack timestamp as a `Date`, or undefined when it is empty or not a valid timestamp. */
+export declare function parseTimestamp(timestamp: string | null | undefined): Date | undefined;
+/** Writes a `Date` as a Baack timestamp: UTC, with milliseconds, without a zone. */
+export declare function toTimestamp(date: Date): string;
+/**
+ * The value for an `<input type="datetime-local">` showing a Baack timestamp in the viewer's local time, or `''`.
+ */
+export declare function toLocalInput(timestamp: string | null | undefined): string;
+/** Reads an `<input type="datetime-local">` value (local time) as a Baack timestamp, or undefined when empty. */
+export declare function fromLocalInput(value: string | null | undefined): string | undefined;
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAIrF;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAKzE;AAED,iHAAiH;AACjH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAInF"}