@atlastodo/shared 0.0.0-stage → 0.1.11-rc.5

package/dist/ids.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Entity ids. Every synced id must be a valid UUID: the server stores `entity_id` in a Postgres
+ * `UUID` column, so a non-UUID id makes `POST /sync/push` reject the whole batch with 422.
+ */
+export declare const PREFERENCES_ID = "00000000-0000-4000-8000-000000000001";
+export declare function derivedUuidV2(namespace: string, key: string): string;
+export declare function derivedUuidV1(namespace: string, key: string): string;

package/dist/importTicktick.d.ts

@@ -0,0 +1,34 @@
+import { type LocalStore } from "@atlastodo/client-core";
+import type { ExportBundle } from "./dataTransfer.js";
+export type TicktickKind = "project" | "section" | "label" | "task";
+export interface TicktickImportOptions {
+    userId: string;
+    reuseLegacyId?: (kind: TicktickKind, id: string) => boolean;
+    timeZone?: string;
+    now?: number;
+}
+export interface TicktickImportCounts {
+    projects: number;
+    sections: number;
+    labels: number;
+    tasks: number;
+    notes: number;
+    subtasks: number;
+    completed: number;
+    abandoned: number;
+}
+export type TicktickWarningCode = "folder" | "noTaskId" | "missingParent" | "repeat" | "reminders" | "checklist" | "timezone";
+export interface TicktickWarning {
+    code: TicktickWarningCode;
+    detail?: string;
+}
+export interface TicktickImportResult {
+    bundle: ExportBundle;
+    counts: TicktickImportCounts;
+    warnings: TicktickWarning[];
+}
+export declare function parseCsvRows(text: string): string[][];
+export declare function ticktickUuid(kind: string, key: string): string;
+export declare function ticktickUuidV2(userId: string, kind: string, key: string): string;
+export declare function ticktickLegacyIdReusable(store: Pick<LocalStore, "get" | "list">): (kind: TicktickKind, id: string) => boolean;
+export declare function ticktickToBundle(text: string, options: TicktickImportOptions): TicktickImportResult;

package/dist/importTodoist.d.ts

@@ -0,0 +1,60 @@
+import type { ExportBundle } from "./dataTransfer.js";
+/**
+ * Todoist import: one project's CSV export, or the backup zip (one CSV per project), converted to
+ * an `ExportBundle` that `importBundle` merges, as the TickTick import does.
+ *
+ * The CSV has no ids, so an entity's id is derived from the importing user and where it sits in
+ * the file (project, section, parent chain, title): importing the same file again updates what the
+ * first import created instead of duplicating it.
+ */
+export type TodoistKind = "project" | "section" | "label" | "task" | "comment";
+export interface TodoistFile {
+    name: string;
+    text: string;
+}
+export interface TodoistImportOptions {
+    userId: string;
+    timeZone?: string;
+    now?: number;
+}
+export interface TodoistImportCounts {
+    projects: number;
+    sections: number;
+    labels: number;
+    tasks: number;
+    subtasks: number;
+    comments: number;
+}
+export type TodoistWarningCode = "notTodoist" | "recurrence" | "date" | "deadline" | "duration" | "assignee" | "projectNote" | "timezone";
+export interface TodoistWarning {
+    code: TodoistWarningCode;
+    detail?: string;
+}
+export interface TodoistImportResult {
+    bundle: ExportBundle;
+    counts: TodoistImportCounts;
+    warnings: TodoistWarning[];
+}
+export declare function todoistUuid(userId: string, kind: TodoistKind, key: string): string;
+/** "Work [2203306141].csv" -> "Work": the backup appends the project id to each file name. */
+export declare function todoistProjectName(fileName: string): string;
+/**
+ * The CSV files of a picked file: every CSV in a backup zip, or the file itself. Decoded with
+ * fflate's own UTF-8 decoder, as Hermes has no `TextDecoder` everywhere.
+ */
+export declare function readTodoistFiles(name: string, bytes: Uint8Array): TodoistFile[];
+interface ParsedDate {
+    dueAt: number;
+    recurrence?: string;
+}
+type DateOutcome = ParsedDate | {
+    unsupported: "recurrence" | "date";
+};
+/**
+ * A Todoist due string ("every monday at 9am", "Oct 12", "2026-10-12") as a due instant, plus an
+ * Atlas rule when it repeats. A repeating task starts on its first occurrence from today, as a
+ * task typed into Todoist would.
+ */
+export declare function parseTodoistDate(raw: string, now: number, timeZone?: string): DateOutcome | null;
+export declare function todoistToBundle(files: TodoistFile[], options: TodoistImportOptions): TodoistImportResult;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * `@atlastodo/shared`: portable, framework-free logic shared across clients. Pure logic only: no DOM,
+ * React or React Native; platform APIs belong in the owning app. May depend on `@atlastodo/client-core`,
+ * not the reverse. A pure rule goes here, something tied to sync/wire types goes in `client-core`,
+ * platform I/O goes in the app.
+ */
+export * from "./theme.js";
+export * from "./ids.js";
+export * from "./i18n.js";
+export * from "./serverUrl.js";
+export * from "./views.js";
+export * from "./zonedTime.js";
+export * from "./format.js";
+export * from "./regions.js";
+export * from "./quickSchedule.js";
+export * from "./cursor.js";
+export * from "./smartLists.js";
+export * from "./planDay.js";
+export * from "./grouping.js";
+export * from "./rank.js";
+export * from "./reorder.js";
+export * from "./boardMove.js";
+export * from "./calendar.js";
+export * from "./filterQuery.js";
+export * from "./fuzzy.js";
+export * from "./taskSearch.js";
+export * from "./taskMapper.js";
+export * from "./projectMapper.js";
+export * from "./sectionMapper.js";
+export * from "./activity.js";
+export * from "./comments.js";
+export * from "./members.js";
+export * from "./taskOps.js";
+export * from "./taskTree.js";
+export * from "./taskListTree.js";
+export * from "./projectTree.js";
+export * from "./sectionOps.js";
+export * from "./duplicateProject.js";
+export * from "./duplicateSection.js";
+export * from "./dataTransfer.js";
+export * from "./importTicktick.js";
+export * from "./importTodoist.js";
+export * from "./recurrence.js";
+export * from "./reminders.js";
+export * from "./reminderSchedule.js";
+export * from "./quickAddParse.js";
+export * from "./habits.js";
+export * from "./habitGroups.js";
+export * from "./habitSchedule.js";
+export * from "./stats.js";
+export * from "./pomodoro.js";
+export * from "./focus.js";
+export * from "./countdown.js";
+export * from "./swipe.js";
+export * from "./hotkeys.js";
+export * from "./avatarColor.js";
+export * from "./priority.js";
+export * from "./taskClipboard.js";
+export * from "./toast.js";
+export * from "./trash.js";
+export * from "./projectStyle.js";
+export * from "./bugReport.js";