@studiometa/productive-core

Shared business logic for Productive.io tools. Provides pure executor functions with injectable dependencies for testability.

Architecture

Executors

Pure functions with the signature (options, context) → ExecutorResult<T>. No I/O side effects — all dependencies are injected via ExecutorContext.

import { listTasks, createTestExecutorContext } from '@studiometa/productive-core';

// In production — context is created from CLI or MCP context
const result = await listTasks({ projectId: '123', status: 'open' }, executorContext);

// In tests — mock only what you need
const ctx = createTestExecutorContext({
  api: { getTasks: vi.fn().mockResolvedValue(mockResponse) },
});
const result = await listTasks({ projectId: '123' }, ctx);

Available Executors

| Resource | Operations | | ------------- | -------------------------------------------------- | | time | list, get, create, update, delete | | projects | list, get, context | | people | list, get | | services | list, get | | companies | list, get, create, update | | tasks | list, get, create, update, context | | deals | list, get, create, update, context | | bookings | list, get, create, update | | comments | list, get, create, update | | timers | list, get, start, stop | | pages | list, get, create, update, delete | | discussions | list, get, create, update, delete, resolve, reopen | | attachments | list, get, delete | | activities | list | | reports | get (11 report types) | | summaries | my_day, project_health, team_pulse | | workflows | complete_task, log_day, weekly_standup |

Context Bridges

Adapters for creating ExecutorContext from CLI or MCP contexts:

import { fromCommandContext } from '@studiometa/productive-core';

// CLI handler
const execCtx = fromCommandContext(ctx);
const result = await listTimeEntries(options, execCtx);

import { fromHandlerContext } from '@studiometa/productive-core';

// MCP handler
const execCtx = fromHandlerContext(ctx, resolveFns);
const result = await listTimeEntries(options, execCtx);

Key Types

interface ExecutorContext {
  api: ProductiveApi;
  resolver: ResourceResolver;
  config: { userId?: string; organizationId: string };
}

interface ExecutorResult<T> {
  data: T;
  meta?: JsonApiMeta;
  included?: IncludedResource[];
  resolved?: Record<string, unknown>;
}

License

MIT © Studio Meta