@ofocus/sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,228 @@
+import type { CliError } from "./errors.js";
+/**
+ * Standard CLI output format for all commands.
+ */
+export interface CliOutput<T> {
+    success: boolean;
+    data: T | null;
+    error: CliError | null;
+}
+export type { CliError } from "./errors.js";
+/**
+ * Metadata about a CLI command for semantic activation by AI agents.
+ */
+export interface CommandInfo {
+    name: string;
+    description: string;
+    usage: string;
+}
+/**
+ * OmniFocus task representation.
+ */
+export interface OFTask {
+    id: string;
+    name: string;
+    note: string | null;
+    flagged: boolean;
+    completed: boolean;
+    dueDate: string | null;
+    deferDate: string | null;
+    completionDate: string | null;
+    projectId: string | null;
+    projectName: string | null;
+    tags: string[];
+    estimatedMinutes: number | null;
+}
+/**
+ * OmniFocus project representation.
+ */
+export interface OFProject {
+    id: string;
+    name: string;
+    note: string | null;
+    status: "active" | "on-hold" | "completed" | "dropped";
+    sequential: boolean;
+    folderId: string | null;
+    folderName: string | null;
+    taskCount: number;
+    remainingTaskCount: number;
+}
+/**
+ * OmniFocus tag representation.
+ */
+export interface OFTag {
+    id: string;
+    name: string;
+    parentId: string | null;
+    parentName: string | null;
+    availableTaskCount: number;
+}
+/**
+ * OmniFocus perspective representation.
+ */
+export interface OFPerspective {
+    id: string;
+    name: string;
+    custom: boolean;
+}
+/**
+ * Options for adding a task to the inbox.
+ */
+export interface InboxOptions {
+    note?: string | undefined;
+    due?: string | undefined;
+    defer?: string | undefined;
+    flag?: boolean | undefined;
+    tags?: string[] | undefined;
+    estimatedMinutes?: number | undefined;
+    repeat?: RepetitionRule | undefined;
+}
+/**
+ * Options for querying tasks.
+ */
+export interface TaskQueryOptions {
+    project?: string | undefined;
+    tag?: string | undefined;
+    dueBefore?: string | undefined;
+    dueAfter?: string | undefined;
+    flagged?: boolean | undefined;
+    completed?: boolean | undefined;
+    available?: boolean | undefined;
+}
+/**
+ * Options for querying projects.
+ */
+export interface ProjectQueryOptions {
+    folder?: string | undefined;
+    status?: "active" | "on-hold" | "completed" | "dropped" | undefined;
+    sequential?: boolean | undefined;
+}
+/**
+ * Options for querying tags.
+ */
+export interface TagQueryOptions {
+    parent?: string | undefined;
+}
+/**
+ * Options for updating a task.
+ */
+export interface TaskUpdateOptions {
+    title?: string | undefined;
+    note?: string | undefined;
+    due?: string | undefined;
+    defer?: string | undefined;
+    flag?: boolean | undefined;
+    project?: string | undefined;
+    tags?: string[] | undefined;
+    estimatedMinutes?: number | undefined;
+    clearEstimate?: boolean | undefined;
+    repeat?: RepetitionRule | undefined;
+    clearRepeat?: boolean | undefined;
+}
+/**
+ * OmniFocus folder representation.
+ */
+export interface OFFolder {
+    id: string;
+    name: string;
+    parentId: string | null;
+    parentName: string | null;
+    projectCount: number;
+    folderCount: number;
+}
+/**
+ * Options for creating a project.
+ */
+export interface CreateProjectOptions {
+    note?: string | undefined;
+    folderId?: string | undefined;
+    folderName?: string | undefined;
+    sequential?: boolean | undefined;
+    status?: "active" | "on-hold" | undefined;
+    dueDate?: string | undefined;
+    deferDate?: string | undefined;
+}
+/**
+ * Options for creating a folder.
+ */
+export interface CreateFolderOptions {
+    parentFolderId?: string | undefined;
+    parentFolderName?: string | undefined;
+}
+/**
+ * Options for querying folders.
+ */
+export interface FolderQueryOptions {
+    parent?: string | undefined;
+}
+/**
+ * Options for creating a tag.
+ */
+export interface CreateTagOptions {
+    parentTagId?: string | undefined;
+    parentTagName?: string | undefined;
+}
+/**
+ * Options for updating a tag.
+ */
+export interface UpdateTagOptions {
+    name?: string | undefined;
+    parentTagId?: string | undefined;
+    parentTagName?: string | undefined;
+}
+/**
+ * OmniFocus task with hierarchy information.
+ */
+export interface OFTaskWithChildren extends OFTask {
+    parentTaskId: string | null;
+    parentTaskName: string | null;
+    childTaskCount: number;
+    isActionGroup: boolean;
+}
+/**
+ * Options for querying subtasks.
+ */
+export interface SubtaskQueryOptions {
+    completed?: boolean | undefined;
+    flagged?: boolean | undefined;
+}
+/**
+ * Result from a batch operation.
+ */
+export interface BatchResult<T> {
+    succeeded: T[];
+    failed: {
+        id: string;
+        error: string;
+    }[];
+    totalSucceeded: number;
+    totalFailed: number;
+}
+/**
+ * Repetition rule for recurring tasks.
+ */
+export interface RepetitionRule {
+    frequency: "daily" | "weekly" | "monthly" | "yearly";
+    interval: number;
+    repeatMethod: "due-again" | "defer-another";
+    daysOfWeek?: number[] | undefined;
+    dayOfMonth?: number | undefined;
+}
+/**
+ * Options for searching tasks.
+ */
+export interface SearchOptions {
+    scope?: "name" | "note" | "both" | undefined;
+    limit?: number | undefined;
+    includeCompleted?: boolean | undefined;
+}
+/**
+ * Result from a review operation.
+ */
+export interface ReviewResult {
+    projectId: string;
+    projectName: string;
+    lastReviewed: string;
+    nextReviewDate: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validation.d.ts

@@ -0,0 +1,57 @@
+import { type CliError } from "./errors.js";
+/**
+ * Validate an OmniFocus ID string.
+ * IDs are alphanumeric with possible dashes/underscores.
+ * Returns null if valid, or a CliError if invalid.
+ */
+export declare function validateId(id: string, type: "task" | "project" | "tag"): CliError | null;
+/**
+ * Validate a date string for use with AppleScript.
+ * Returns null if valid (or empty), or a CliError if invalid.
+ *
+ * Note: We do basic validation here; the actual date parsing
+ * is done by AppleScript and more detailed errors come from there.
+ */
+export declare function validateDateString(dateStr: string): CliError | null;
+/**
+ * Validate a list of tag names.
+ * Returns null if valid, or a CliError if any tag is invalid.
+ */
+export declare function validateTags(tags: string[] | undefined): CliError | null;
+/**
+ * Validate a project name.
+ * Returns null if valid (or empty), or a CliError if invalid.
+ */
+export declare function validateProjectName(name: string | undefined): CliError | null;
+/**
+ * Validate a folder name.
+ * Returns null if valid (or empty), or a CliError if invalid.
+ */
+export declare function validateFolderName(name: string | undefined): CliError | null;
+/**
+ * Validate a tag name for creation/update.
+ * Returns null if valid, or a CliError if invalid.
+ */
+export declare function validateTagName(name: string): CliError | null;
+/**
+ * Validate a repetition rule.
+ * Returns null if valid (or undefined), or a CliError if invalid.
+ */
+export declare function validateRepetitionRule(rule: {
+    frequency: string;
+    interval: number;
+    repeatMethod: string;
+    daysOfWeek?: number[] | undefined;
+    dayOfMonth?: number | undefined;
+} | undefined): CliError | null;
+/**
+ * Validate an estimated minutes value.
+ * Returns null if valid (or undefined), or a CliError if invalid.
+ */
+export declare function validateEstimatedMinutes(minutes: number | undefined): CliError | null;
+/**
+ * Validate a search query.
+ * Returns null if valid, or a CliError if invalid.
+ */
+export declare function validateSearchQuery(query: string): CliError | null;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAA0B,MAAM,aAAa,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAC/B,QAAQ,GAAG,IAAI,CAoBjB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CA4BnE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAwBxE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAe7E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAe5E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAkB7D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,GAClJ,QAAQ,GAAG,IAAI,CA4DjB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,QAAQ,GAAG,IAAI,CAcjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAkBlE"}

package/dist/validation.js

@@ -0,0 +1,172 @@
+import { ErrorCode, createError } from "./errors.js";
+/**
+ * Validate an OmniFocus ID string.
+ * IDs are alphanumeric with possible dashes/underscores.
+ * Returns null if valid, or a CliError if invalid.
+ */
+export function validateId(id, type) {
+    if (!id || id.trim() === "") {
+        return createError(ErrorCode.INVALID_ID_FORMAT, `${capitalize(type)} ID cannot be empty`);
+    }
+    // OmniFocus IDs are typically alphanumeric with possible dashes/underscores
+    // They should not contain special characters that could be used for injection
+    const idPattern = /^[a-zA-Z0-9_-]+$/;
+    if (!idPattern.test(id)) {
+        return createError(ErrorCode.INVALID_ID_FORMAT, `Invalid ${type} ID format: ${id}`, "IDs must contain only alphanumeric characters, dashes, and underscores");
+    }
+    return null;
+}
+/**
+ * Validate a date string for use with AppleScript.
+ * Returns null if valid (or empty), or a CliError if invalid.
+ *
+ * Note: We do basic validation here; the actual date parsing
+ * is done by AppleScript and more detailed errors come from there.
+ */
+export function validateDateString(dateStr) {
+    // Empty dates are valid (used to clear a date)
+    if (!dateStr || dateStr.trim() === "") {
+        return null;
+    }
+    // Check for obvious injection attempts
+    // AppleScript date strings should not contain quotes or backslashes
+    if (dateStr.includes('"') || dateStr.includes("\\")) {
+        return createError(ErrorCode.INVALID_DATE_FORMAT, "Invalid characters in date string", "Date strings cannot contain quotes or backslashes");
+    }
+    // Basic format check - should look like a date
+    // AppleScript accepts various formats like "January 1, 2024" or "1/1/2024 5:00 PM"
+    // We allow letters, numbers, spaces, slashes, colons, commas, and dashes
+    const datePattern = /^[a-zA-Z0-9\s/:,.-]+$/;
+    if (!datePattern.test(dateStr)) {
+        return createError(ErrorCode.INVALID_DATE_FORMAT, `Invalid date format: ${dateStr}`);
+    }
+    return null;
+}
+/**
+ * Validate a list of tag names.
+ * Returns null if valid, or a CliError if any tag is invalid.
+ */
+export function validateTags(tags) {
+    if (!tags || tags.length === 0) {
+        return null;
+    }
+    for (const tag of tags) {
+        if (!tag || tag.trim() === "") {
+            return createError(ErrorCode.VALIDATION_ERROR, "Tag name cannot be empty");
+        }
+        // Tag names should not contain characters that could cause injection
+        if (tag.includes('"') || tag.includes("\\")) {
+            return createError(ErrorCode.VALIDATION_ERROR, `Invalid characters in tag name: ${tag}`, "Tag names cannot contain quotes or backslashes");
+        }
+    }
+    return null;
+}
+/**
+ * Validate a project name.
+ * Returns null if valid (or empty), or a CliError if invalid.
+ */
+export function validateProjectName(name) {
+    if (!name || name.trim() === "") {
+        return null;
+    }
+    // Project names should not contain characters that could cause injection
+    if (name.includes('"') || name.includes("\\")) {
+        return createError(ErrorCode.VALIDATION_ERROR, `Invalid characters in project name: ${name}`, "Project names cannot contain quotes or backslashes");
+    }
+    return null;
+}
+/**
+ * Validate a folder name.
+ * Returns null if valid (or empty), or a CliError if invalid.
+ */
+export function validateFolderName(name) {
+    if (!name || name.trim() === "") {
+        return null;
+    }
+    // Folder names should not contain characters that could cause injection
+    if (name.includes('"') || name.includes("\\")) {
+        return createError(ErrorCode.VALIDATION_ERROR, `Invalid characters in folder name: ${name}`, "Folder names cannot contain quotes or backslashes");
+    }
+    return null;
+}
+/**
+ * Validate a tag name for creation/update.
+ * Returns null if valid, or a CliError if invalid.
+ */
+export function validateTagName(name) {
+    if (!name || name.trim() === "") {
+        return createError(ErrorCode.VALIDATION_ERROR, "Tag name cannot be empty");
+    }
+    // Tag names should not contain characters that could cause injection
+    if (name.includes('"') || name.includes("\\")) {
+        return createError(ErrorCode.VALIDATION_ERROR, `Invalid characters in tag name: ${name}`, "Tag names cannot contain quotes or backslashes");
+    }
+    return null;
+}
+/**
+ * Validate a repetition rule.
+ * Returns null if valid (or undefined), or a CliError if invalid.
+ */
+export function validateRepetitionRule(rule) {
+    if (!rule) {
+        return null;
+    }
+    const validFrequencies = ["daily", "weekly", "monthly", "yearly"];
+    if (!validFrequencies.includes(rule.frequency)) {
+        return createError(ErrorCode.VALIDATION_ERROR, `Invalid repetition frequency: ${rule.frequency}`, "Valid frequencies are: daily, weekly, monthly, yearly");
+    }
+    if (rule.interval < 1 || !Number.isInteger(rule.interval)) {
+        return createError(ErrorCode.VALIDATION_ERROR, `Invalid repetition interval: ${String(rule.interval)}`, "Interval must be a positive integer");
+    }
+    const validMethods = ["due-again", "defer-another"];
+    if (!validMethods.includes(rule.repeatMethod)) {
+        return createError(ErrorCode.VALIDATION_ERROR, `Invalid repeat method: ${rule.repeatMethod}`, "Valid methods are: due-again, defer-another");
+    }
+    if (rule.daysOfWeek !== undefined) {
+        if (!Array.isArray(rule.daysOfWeek) || rule.daysOfWeek.length === 0) {
+            return createError(ErrorCode.VALIDATION_ERROR, "daysOfWeek must be a non-empty array");
+        }
+        for (const day of rule.daysOfWeek) {
+            if (day < 0 || day > 6 || !Number.isInteger(day)) {
+                return createError(ErrorCode.VALIDATION_ERROR, `Invalid day of week: ${String(day)}`, "Days of week must be integers 0-6 (Sunday=0, Saturday=6)");
+            }
+        }
+    }
+    if (rule.dayOfMonth !== undefined) {
+        if (rule.dayOfMonth < 1 || rule.dayOfMonth > 31 || !Number.isInteger(rule.dayOfMonth)) {
+            return createError(ErrorCode.VALIDATION_ERROR, `Invalid day of month: ${String(rule.dayOfMonth)}`, "Day of month must be an integer 1-31");
+        }
+    }
+    return null;
+}
+/**
+ * Validate an estimated minutes value.
+ * Returns null if valid (or undefined), or a CliError if invalid.
+ */
+export function validateEstimatedMinutes(minutes) {
+    if (minutes === undefined) {
+        return null;
+    }
+    if (!Number.isInteger(minutes) || minutes < 0) {
+        return createError(ErrorCode.VALIDATION_ERROR, `Invalid estimated minutes: ${String(minutes)}`, "Estimated minutes must be a non-negative integer");
+    }
+    return null;
+}
+/**
+ * Validate a search query.
+ * Returns null if valid, or a CliError if invalid.
+ */
+export function validateSearchQuery(query) {
+    if (!query || query.trim() === "") {
+        return createError(ErrorCode.VALIDATION_ERROR, "Search query cannot be empty");
+    }
+    // Search queries should not contain characters that could cause injection
+    if (query.includes('"') || query.includes("\\")) {
+        return createError(ErrorCode.VALIDATION_ERROR, "Invalid characters in search query", "Search queries cannot contain quotes or backslashes");
+    }
+    return null;
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/docs/index.md

@@ -0,0 +1,30 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md)
+
+## API Reference
+
+## Packages
+
+<table><thead><tr><th>
+
+Package
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[@ofocus/sdk](./sdk.md)
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+

package/docs/sdk.addtoinbox.md

@@ -0,0 +1,68 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@ofocus/sdk](./sdk.md) &gt; [addToInbox](./sdk.addtoinbox.md)
+
+## addToInbox() function
+
+Add a task to the OmniFocus inbox.
+
+**Signature:**
+
+```typescript
+export declare function addToInbox(title: string, options?: InboxOptions): Promise<CliOutput<OFTask>>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+title
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+options
+
+
+</td><td>
+
+[InboxOptions](./sdk.inboxoptions.md)
+
+
+</td><td>
+
+_(Optional)_
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Promise&lt;[CliOutput](./sdk.clioutput.md)<!-- -->&lt;[OFTask](./sdk.oftask.md)<!-- -->&gt;&gt;
+

package/docs/sdk.applescriptresult.data.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@ofocus/sdk](./sdk.md) &gt; [AppleScriptResult](./sdk.applescriptresult.md) &gt; [data](./sdk.applescriptresult.data.md)
+
+## AppleScriptResult.data property
+
+**Signature:**
+
+```typescript
+data?: T;
+```

package/docs/sdk.applescriptresult.error.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@ofocus/sdk](./sdk.md) &gt; [AppleScriptResult](./sdk.applescriptresult.md) &gt; [error](./sdk.applescriptresult.error.md)
+
+## AppleScriptResult.error property
+
+**Signature:**
+
+```typescript
+error?: CliError;
+```