@tightknitai/tightknit 0.1.0-alpha.7 → 0.1.0-alpha.9

package/README.md

@@ -1,94 +1,57 @@
 # @tightknitai/tightknit
 
-Command-line interface and MCP server for the [Tightknit API](https://docs.tightknit.ai/api-reference/introduction).
-
-## Setup
-
-### Prerequisites
-
-- Node.js 18+ (for native `fetch`)
-- A Tightknit API key
-
-### Create an API Key
-
-1. Go to **Studio > Settings > Integrations > API Keys**
-2. Click **Create API key**
-3. Give it a descriptive name (e.g. "CLI")
-4. Select the permissions for the APIs the key needs access to. Enable all permissions the CLI commands you plan to use require:
-   - **Calendar Events** — `events list`, `events get`, `events create`, `events delete`, `events update-attendee`
-   - **Feeds** — `feeds list`, `feeds get`, `feeds posts`
-   - **Posts** — `posts get`
-   - **Members** — `members add` (Enterprise), `members check`
-   - **Messages** — `messages send`
-   - **Groups** — `groups add-member`
-   - **Awards** — `awards assign`
-   - **Search** — `search query` (Beta)
-5. Copy the key (starts with `sk_`) — it is only shown once
-
-### Install and Configure
-
-```bash
-# Via npm
-npx -p @tightknitai/tightknit@alpha tightknit config set api-key sk_your_key_here
+> **Alpha** — APIs and commands may change between releases.
 
-# Or from the monorepo root
-pnpm install
-npx tsx packages/tightknit-cli/bin/tightknit.ts config set api-key sk_your_key_here
-```
-
-The API key is stored locally at `~/.config/tightknit/config.json`. Alternatively, set the `TIGHTKNIT_API_KEY` environment variable (takes precedence over stored config).
+Command-line interface and MCP server for the [Tightknit API](https://docs.tightknit.ai/api-reference/introduction).
 
-## Usage
+**Full documentation:** [docs.tightknit.ai/integrations/cli](https://docs.tightknit.ai/integrations/cli)
 
-### CLI Commands
+## Quick Start
 
 ```bash
-# Alias for convenience
-alias tightknit="npx tsx packages/tightknit-cli/bin/tightknit.ts"
+# Install globally
+npm install -g @tightknitai/tightknit@alpha
 
-# Calendar Events
-tightknit events list
-tightknit events list --time-filter upcoming --status published --json
-tightknit events get <event-id>
-tightknit events create --title "Meetup" --description "Join us" --start-date "2025-06-01T18:00:00Z" --end-date "2025-06-01T20:00:00Z"
-tightknit events delete <event-id>
-tightknit events update-attendee <event-id> --email user@example.com --personal-join-link "https://zoom.us/..."
+# Or run without installing
+npx @tightknitai/tightknit@alpha --help
 
-# Awards
-tightknit awards assign <award-uuid> --recipient-email user@example.com
+# Set your API key
+tightknit config set api-key sk_your_key_here
 
-# Feeds & Posts
+# Try it out
 tightknit feeds list
-tightknit feeds get <feed-id>
-tightknit feeds posts <feed-id> --sort newest
-tightknit posts get <post-id>
+tightknit events list --time-filter upcoming --json
+```
 
-# Members
-tightknit members add --email user@example.com --full-name "Jane Doe"
-tightknit members check user@example.com
+## Authentication
 
-# Messages
-tightknit messages send --channel C0123456 --text "Hello from CLI!"
+The CLI resolves your API key in this order:
 
-# Groups
-tightknit groups add-member <group-id> --email user@example.com
+1. `--api-key <key>` flag (highest precedence)
+2. `TIGHTKNIT_API_KEY` environment variable
+3. Stored config (`~/.config/tightknit/config.json`)
 
-# Search (Beta)
-tightknit search query "community meetup" --type post
+## Commands
 
-# Config
-tightknit config set api-key <key>
-tightknit config get api-key
-tightknit config set default-output json
-```
+| Command Group | Commands |
+|---------------|----------|
+| `events` | `list`, `get`, `create`, `delete`, `update-attendee` |
+| `feeds` | `list`, `get`, `posts` |
+| `posts` | `get` |
+| `members` | `add`, `check` |
+| `messages` | `send` |
+| `groups` | `add-member` |
+| `awards` | `assign` |
+| `search` | `query` (Beta) |
+| `config` | `set`, `get` |
+| `completion` | `bash`, `zsh`, `fish` |
+| `mcp` | Start the MCP server |
 
-Every command supports `--json` for structured JSON output and `--help` for usage info.
+Every command supports `--json` for structured output and `--help` for usage details.
 
-### MCP Server (for Claude Code)
+## MCP Server
 
-The MCP server exposes all CLI commands as tools over STDIO.
-
-Add to your Claude Code MCP config (`.claude/settings.json` or `~/.claude.json`):
+The built-in MCP server exposes all CLI commands as tools for AI agents.
 
 ```json
 {
@@ -104,31 +67,6 @@ Add to your Claude Code MCP config (`.claude/settings.json` or `~/.claude.json`)
 }
 ```
 
-Or if installed locally in the monorepo:
-
-```json
-{
-  "mcpServers": {
-    "tightknit": {
-      "command": "npx",
-      "args": ["tsx", "packages/tightknit-cli/bin/tightknit.ts", "mcp"],
-      "cwd": "/path/to/colombo",
-      "env": {
-        "TIGHTKNIT_API_KEY": "sk_your_key_here"
-      }
-    }
-  }
-}
-```
-
-This gives Claude access to 17 tools: `tightknit_events_list`, `tightknit_events_create`, `tightknit_feeds_list`, `tightknit_messages_send`, etc.
-
-**Authentication:** The API key can be provided two ways:
-- **`TIGHTKNIT_API_KEY` env var** (recommended for MCP) — pass it in the MCP config as shown above
-- **`tightknit config set api-key <key>`** — persists to `~/.config/tightknit/config.json`, good for CLI usage
-
-The env var takes precedence if both are set.
-
 ## Development
 
 ```bash
@@ -138,30 +76,16 @@ pnpm --filter @tightknitai/tightknit test
 # Type check
 pnpm --filter @tightknitai/tightknit typecheck
 
-# Run CLI in dev mode
-npx tsx packages/tightknit-cli/bin/tightknit.ts --help
+# Build
+pnpm --filter @tightknitai/tightknit build
+
+# Run in dev mode (uses tsx, no build needed)
+pnpm --filter @tightknitai/tightknit dev
+
+# Test MCP server with Inspector
+pnpm --filter @tightknitai/tightknit test:mcp
 ```
 
-## API Coverage
-
-All endpoints from the [Tightknit Admin API](https://api.tightknit.ai/doc) (`/admin/v0/`) are supported:
-
-| Method | Path | CLI Command |
-|--------|------|-------------|
-| GET | `/calendar_events` | `events list` |
-| POST | `/calendar_events` | `events create` |
-| GET | `/calendar_events/:id` | `events get` |
-| DELETE | `/calendar_events/:id` | `events delete` |
-| PATCH | `/calendar_events/:id/attendees` | `events update-attendee` |
-| POST | `/awards/:id/assign` | `awards assign` |
-| GET | `/feeds` | `feeds list` |
-| GET | `/feeds/:id` | `feeds get` |
-| GET | `/feeds/:id/posts` | `feeds posts` |
-| GET | `/posts/:id` | `posts get` |
-| POST | `/members` | `members add` |
-| POST | `/members/check` | `members check` |
-| POST | `/messages` | `messages send` |
-| POST | `/groups/:id/members` | `groups add-member` |
-| GET | `/search` | `search query` |
-
-Not yet implemented: `POST /files` (file upload — requires multipart form handling).
+## License
+
+Apache-2.0

package/bin/tightknit.js

@@ -5,6 +5,7 @@ checkForUpdates();
 
 const program = createProgram();
 
-program.parseAsync(process.argv).catch(() => {
+program.parseAsync(process.argv).catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
   process.exit(1);
 });

package/dist/{chunk-PRA5JZ27.js → chunk-WSRTDKVW.js}

@@ -24,8 +24,18 @@ function getDefaultOutput() {
 function setDefaultOutput(format) {
   config.set("defaultOutput", format);
 }
+var VALID_ENVIRONMENTS = /* @__PURE__ */ new Set(["production", "staging"]);
 function getEnvironment() {
-  return process.env.TIGHTKNIT_ENVIRONMENT || config.get("environment");
+  const envVar = process.env.TIGHTKNIT_ENVIRONMENT;
+  if (envVar) {
+    if (!VALID_ENVIRONMENTS.has(envVar)) {
+      throw new Error(
+        `Invalid TIGHTKNIT_ENVIRONMENT: "${envVar}". Must be "production" or "staging"`
+      );
+    }
+    return envVar;
+  }
+  return config.get("environment");
 }
 function setEnvironment(env) {
   config.set("environment", env);
@@ -40,7 +50,9 @@ function getConfigValue(key) {
     case "environment":
       return getEnvironment();
     default:
-      throw new Error(`Unknown config key: ${key}. Valid keys: ${VALID_CONFIG_KEYS}`);
+      throw new Error(
+        `Unknown config key: ${key}. Valid keys: ${VALID_CONFIG_KEYS}`
+      );
   }
 }
 function setConfigValue(key, value) {
@@ -50,18 +62,24 @@ function setConfigValue(key, value) {
       break;
     case "default-output":
       if (value !== "json" && value !== "table") {
-        throw new Error(`Invalid output format: ${value}. Must be "json" or "table"`);
+        throw new Error(
+          `Invalid output format: ${value}. Must be "json" or "table"`
+        );
       }
       setDefaultOutput(value);
       break;
     case "environment":
       if (value !== "production" && value !== "staging") {
-        throw new Error(`Invalid environment: ${value}. Must be "production" or "staging"`);
+        throw new Error(
+          `Invalid environment: ${value}. Must be "production" or "staging"`
+        );
       }
       setEnvironment(value);
       break;
     default:
-      throw new Error(`Unknown config key: ${key}. Valid keys: ${VALID_CONFIG_KEYS}`);
+      throw new Error(
+        `Unknown config key: ${key}. Valid keys: ${VALID_CONFIG_KEYS}`
+      );
   }
 }
 function getConfigPath() {
@@ -72,6 +90,8 @@ function getConfigPath() {
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
 import { dirname, join } from "path";
+var MissingVersionError = class extends Error {
+};
 function readVersion() {
   let dir = dirname(fileURLToPath(import.meta.url));
   for (let i = 0; i < 5; i++) {
@@ -79,13 +99,23 @@ function readVersion() {
       const pkgPath = join(dir, "package.json");
       const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
       if (pkg.name === "@tightknitai/tightknit") {
-        return pkg.version ?? "0.0.0";
+        if (!pkg.version) {
+          throw new MissingVersionError(
+            `Found @tightknitai/tightknit package.json at ${pkgPath} but "version" field is missing`
+          );
+        }
+        return pkg.version;
+      }
+    } catch (err) {
+      if (err instanceof MissingVersionError) {
+        throw err;
       }
-    } catch {
     }
     dir = dirname(dir);
   }
-  return "0.0.0";
+  throw new Error(
+    "Could not find @tightknitai/tightknit package.json within 5 parent directories"
+  );
 }
 var VERSION = readVersion();
 
@@ -96,7 +126,7 @@ var BASE_URLS = {
 };
 var API_PREFIX = "/admin/v0";
 function getBaseUrl() {
-  return BASE_URLS[getEnvironment()];
+  return process.env.TIGHTKNIT_API_URL || BASE_URLS[getEnvironment()];
 }
 function buildUrl(path, params) {
   const url = new URL(`${API_PREFIX}${path}`, getBaseUrl());
@@ -113,7 +143,7 @@ async function parseErrorResponse(response) {
   let message;
   try {
     const body = await response.json();
-    message = body.message || body.error || response.statusText;
+    message = JSON.stringify(body);
   } catch {
     message = response.statusText;
   }
@@ -176,11 +206,15 @@ async function listEvents(params) {
   );
 }
 async function createEvent(input) {
-  return apiRequest("/calendar_events", {
-    method: "POST",
-    body: input,
-    idempotencyKey: crypto.randomUUID()
-  });
+  const { description, ...rest } = input;
+  return apiRequest(
+    "/calendar_events",
+    {
+      method: "POST",
+      body: { ...rest, description: { text: description } },
+      idempotencyKey: crypto.randomUUID()
+    }
+  );
 }
 async function getEvent(id) {
   return apiRequest(`/calendar_events/${id}`);
@@ -250,12 +284,16 @@ async function sendMessage(input) {
 async function search(params) {
   return apiRequest(
     "/search",
-    { params }
+    {
+      params
+    }
   );
 }
 
 export {
   setRuntimeApiKey,
+  getApiKey,
+  getDefaultOutput,
   getConfigValue,
   setConfigValue,
   getConfigPath,
@@ -277,4 +315,4 @@ export {
   sendMessage,
   search
 };
-//# sourceMappingURL=chunk-PRA5JZ27.js.map
+//# sourceMappingURL=chunk-WSRTDKVW.js.map

package/dist/chunk-WSRTDKVW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/config.ts","../src/core/version.ts","../src/core/client.ts"],"sourcesContent":["import Conf from 'conf';\n\nexport type Environment = 'production' | 'staging';\n\ninterface TightknitConfig {\n  apiKey: string;\n  defaultOutput: 'json' | 'table';\n  environment: Environment;\n}\n\nconst config = new Conf<TightknitConfig>({\n  projectName: 'tightknit',\n  defaults: {\n    apiKey: '',\n    defaultOutput: 'table',\n    environment: 'production'\n  }\n});\n\n/** Runtime API key set via --api-key flag (highest precedence) */\nlet runtimeApiKey: string | undefined;\n\n/** Set a runtime API key (from --api-key flag). Takes highest precedence. */\nexport function setRuntimeApiKey(key: string | undefined): void {\n  runtimeApiKey = key;\n}\n\n/** Get the API key — --api-key flag > env var > stored config */\nexport function getApiKey(): string {\n  return runtimeApiKey || process.env.TIGHTKNIT_API_KEY || config.get('apiKey');\n}\n\n/** Set the API key */\nexport function setApiKey(key: string): void {\n  config.set('apiKey', key);\n}\n\n/** Get the default output format */\nexport function getDefaultOutput(): 'json' | 'table' {\n  return config.get('defaultOutput');\n}\n\n/** Set the default output format */\nexport function setDefaultOutput(format: 'json' | 'table'): void {\n  config.set('defaultOutput', format);\n}\n\nconst VALID_ENVIRONMENTS = new Set<string>(['production', 'staging']);\n\n/** Get the configured environment */\nexport function getEnvironment(): Environment {\n  const envVar = process.env.TIGHTKNIT_ENVIRONMENT;\n  if (envVar) {\n    if (!VALID_ENVIRONMENTS.has(envVar)) {\n      throw new Error(\n        `Invalid TIGHTKNIT_ENVIRONMENT: \"${envVar}\". Must be \"production\" or \"staging\"`\n      );\n    }\n    return envVar as Environment;\n  }\n  return config.get('environment');\n}\n\n/** Set the environment */\nexport function setEnvironment(env: Environment): void {\n  config.set('environment', env);\n}\n\nconst VALID_CONFIG_KEYS = 'api-key, default-output, environment';\n\n/** Get a config value by key name */\nexport function getConfigValue(key: string): string {\n  switch (key) {\n    case 'api-key':\n      return getApiKey();\n    case 'default-output':\n      return getDefaultOutput();\n    case 'environment':\n      return getEnvironment();\n    default:\n      throw new Error(\n        `Unknown config key: ${key}. Valid keys: ${VALID_CONFIG_KEYS}`\n      );\n  }\n}\n\n/** Set a config value by key name */\nexport function setConfigValue(key: string, value: string): void {\n  switch (key) {\n    case 'api-key':\n      setApiKey(value);\n      break;\n    case 'default-output':\n      if (value !== 'json' && value !== 'table') {\n        throw new Error(\n          `Invalid output format: ${value}. Must be \"json\" or \"table\"`\n        );\n      }\n      setDefaultOutput(value);\n      break;\n    case 'environment':\n      if (value !== 'production' && value !== 'staging') {\n        throw new Error(\n          `Invalid environment: ${value}. Must be \"production\" or \"staging\"`\n        );\n      }\n      setEnvironment(value);\n      break;\n    default:\n      throw new Error(\n        `Unknown config key: ${key}. Valid keys: ${VALID_CONFIG_KEYS}`\n      );\n  }\n}\n\n/** Get the config file path (useful for debugging) */\nexport function getConfigPath(): string {\n  return config.path;\n}\n","import { readFileSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, join } from 'node:path';\n\nclass MissingVersionError extends Error {}\n\n/** Walks up from the current module to find the CLI's package.json version */\nfunction readVersion(): string {\n  let dir = dirname(fileURLToPath(import.meta.url));\n  for (let i = 0; i < 5; i++) {\n    try {\n      const pkgPath = join(dir, 'package.json');\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as {\n        name?: string;\n        version?: string;\n      };\n      if (pkg.name === '@tightknitai/tightknit') {\n        if (!pkg.version) {\n          throw new MissingVersionError(\n            `Found @tightknitai/tightknit package.json at ${pkgPath} but \"version\" field is missing`\n          );\n        }\n        return pkg.version;\n      }\n    } catch (err) {\n      if (err instanceof MissingVersionError) {\n        throw err;\n      }\n      // Expected when traversing directories without package.json — keep walking\n    }\n    dir = dirname(dir);\n  }\n  throw new Error(\n    'Could not find @tightknitai/tightknit package.json within 5 parent directories'\n  );\n}\n\nexport const VERSION = readVersion();\n","import { getApiKey, getEnvironment } from './config';\nimport type { ApiError } from './types';\n\nconst BASE_URLS = {\n  production: 'https://api.tightknit.ai',\n  staging: 'https://staging-api.tightknit.ai'\n} as const;\n\nconst API_PREFIX = '/admin/v0';\n\n/** TIGHTKNIT_API_URL env var takes highest precedence for custom deployments and testing */\nfunction getBaseUrl(): string {\n  return process.env.TIGHTKNIT_API_URL || BASE_URLS[getEnvironment()];\n}\n\ninterface RequestOptions {\n  method?: 'GET' | 'POST' | 'PATCH' | 'DELETE';\n  body?: Record<string, unknown>;\n  params?: Record<string, string | number | boolean | undefined>;\n  idempotencyKey?: string;\n}\n\n/** Build a URL with query parameters */\nfunction buildUrl(\n  path: string,\n  params?: Record<string, string | number | boolean | undefined>\n): string {\n  const url = new URL(`${API_PREFIX}${path}`, getBaseUrl());\n  if (params) {\n    for (const [key, value] of Object.entries(params)) {\n      if (value !== undefined) {\n        url.searchParams.set(key, String(value));\n      }\n    }\n  }\n  return url.toString();\n}\n\n/** Parse an API error response into a structured error */\nasync function parseErrorResponse(response: Response): Promise<ApiError> {\n  let message: string;\n  try {\n    const body = (await response.json()) as Record<string, unknown>;\n    message = JSON.stringify(body);\n  } catch {\n    message = response.statusText;\n  }\n\n  return {\n    error: true,\n    code: response.status,\n    message: `${message} (${response.status})`\n  };\n}\n\n/** Make an authenticated request to the Tightknit API */\nexport async function apiRequest<T>(\n  path: string,\n  options: RequestOptions = {}\n): Promise<T> {\n  const { method = 'GET', body, params, idempotencyKey } = options;\n\n  const apiKey = getApiKey();\n  if (!apiKey) {\n    throw new TightknitApiError(\n      'No API key configured. Run: tightknit config set api-key <YOUR_KEY>',\n      401\n    );\n  }\n\n  const headers: Record<string, string> = {\n    Authorization: `Bearer ${apiKey}`,\n    'Content-Type': 'application/json'\n  };\n\n  if (idempotencyKey && (method === 'POST' || method === 'PATCH')) {\n    headers['Idempotency-Key'] = idempotencyKey;\n  }\n\n  const url = buildUrl(path, params);\n\n  const response = await fetch(url, {\n    method,\n    headers,\n    body: body ? JSON.stringify(body) : undefined\n  });\n\n  if (!response.ok) {\n    const apiError = await parseErrorResponse(response);\n    throw new TightknitApiError(apiError.message, apiError.code);\n  }\n\n  if (response.status === 204) {\n    return undefined as T;\n  }\n\n  return (await response.json()) as T;\n}\n\n/** Custom error class for Tightknit API errors */\nexport class TightknitApiError extends Error {\n  code: number;\n\n  constructor(message: string, code: number) {\n    super(message);\n    this.name = 'TightknitApiError';\n    this.code = code;\n  }\n\n  toJSON(): ApiError {\n    return {\n      error: true,\n      code: this.code,\n      message: this.message\n    };\n  }\n}\n\n// --- Calendar Events ---\n// Paths use underscores: /calendar_events\n\nexport interface ListEventsParams {\n  page?: number;\n  per_page?: number;\n  time_filter?: 'upcoming' | 'past';\n  date_filter?: string;\n  status?: 'draft' | 'needs_approval' | 'published';\n  published_to_site?: boolean;\n  is_unlisted?: boolean;\n  feed_id?: string;\n  tag_ids?: string;\n}\n\n/**\n * List calendar events with optional filtering and pagination.\n * @param params - Optional filters for time, status, feed, pagination, etc.\n * @returns Paginated list of calendar events.\n */\nexport async function listEvents(params?: ListEventsParams) {\n  return apiRequest<{ data: unknown[]; page: number; per_page: number }>(\n    '/calendar_events',\n    { params: params as Record<string, string | number | boolean | undefined> }\n  );\n}\n\nexport interface CreateEventInput {\n  title: string;\n  description: string;\n  start_date: string;\n  end_date: string;\n  location?: string;\n  link?: string;\n  status?: 'needs_approval' | 'published';\n  slug?: string;\n  publish_to_site?: boolean;\n  is_unlisted?: boolean;\n  allow_public_guest_list?: boolean;\n  enable_registration_button?: boolean;\n  triggers_webhooks?: boolean;\n  external_speakers?: string;\n  cover_image_file_id?: string;\n  reminders_config?: number[];\n  publish_to_slack_channels?: string[];\n}\n\n/**\n * Create a new calendar event.\n * @param input - Event details including title, dates, and optional settings.\n * @returns The created event's ID and success status.\n */\nexport async function createEvent(input: CreateEventInput) {\n  const { description, ...rest } = input;\n  return apiRequest<{ success: boolean; data: { calendar_event_id: string } }>(\n    '/calendar_events',\n    {\n      method: 'POST',\n      body: { ...rest, description: { text: description } },\n      idempotencyKey: crypto.randomUUID()\n    }\n  );\n}\n\n/**\n * Get a single calendar event by ID.\n * @param id - The calendar event ID.\n * @returns The calendar event details.\n */\nexport async function getEvent(id: string) {\n  return apiRequest<unknown>(`/calendar_events/${id}`);\n}\n\n/**\n * Delete a calendar event by ID.\n * @param id - The calendar event ID.\n * @returns void on success (204 response).\n */\nexport async function deleteEvent(id: string) {\n  return apiRequest<void>(`/calendar_events/${id}`, { method: 'DELETE' });\n}\n\nexport interface UpdateAttendeeInput {\n  user: { slack_user_id: string } | { email: string } | { profile_id: string };\n  personal_join_link?: string;\n}\n\n/**\n * Update or add an attendee for a calendar event.\n * @param eventId - The calendar event ID.\n * @param input - Attendee user identifier and optional join link.\n * @returns The updated attendee details.\n */\nexport async function updateAttendee(\n  eventId: string,\n  input: UpdateAttendeeInput\n) {\n  return apiRequest<unknown>(`/calendar_events/${eventId}/attendees`, {\n    method: 'PATCH',\n    body: input as unknown as Record<string, unknown>,\n    idempotencyKey: crypto.randomUUID()\n  });\n}\n\n// --- Awards ---\n\nexport interface AssignAwardInput {\n  recipient:\n    | { slack_user_id: string }\n    | { email: string }\n    | { profile_id: string };\n  sender?:\n    | { slack_user_id: string }\n    | { email: string }\n    | { profile_id: string }\n    | null;\n  send_anonymously?: boolean;\n}\n\n/**\n * Assign an award to a recipient.\n * @param awardId - The award ID to assign.\n * @param input - Recipient identifier and optional sender/anonymity settings.\n * @returns Success status.\n */\nexport async function assignAward(awardId: string, input: AssignAwardInput) {\n  return apiRequest<{ success: boolean }>(`/awards/${awardId}/assign`, {\n    method: 'POST',\n    body: input as unknown as Record<string, unknown>,\n    idempotencyKey: crypto.randomUUID()\n  });\n}\n\n// --- Feeds ---\n\nexport interface ListFeedsParams {\n  page?: number;\n  per_page?: number;\n  is_unlisted?: boolean;\n  is_archived?: boolean;\n}\n\n/**\n * List feeds with optional filtering and pagination.\n * @param params - Optional filters for unlisted/archived status and pagination.\n * @returns Paginated list of feeds.\n */\nexport async function listFeeds(params?: ListFeedsParams) {\n  return apiRequest<{ data: unknown[]; page: number; per_page: number }>(\n    '/feeds',\n    { params: params as Record<string, string | number | boolean | undefined> }\n  );\n}\n\n/**\n * Get a single feed by ID.\n * @param feedId - The feed ID.\n * @returns The feed details.\n */\nexport async function getFeed(feedId: string) {\n  return apiRequest<unknown>(`/feeds/${feedId}`);\n}\n\nexport interface ListPostsInFeedParams {\n  page?: number;\n  per_page?: number;\n  sort?: 'oldest' | 'newest' | 'most-recent-activity';\n}\n\n/**\n * List posts within a feed with optional sorting and pagination.\n * @param feedId - The feed ID to list posts from.\n * @param params - Optional sort order and pagination.\n * @returns Paginated list of posts.\n */\nexport async function listPostsInFeed(\n  feedId: string,\n  params?: ListPostsInFeedParams\n) {\n  return apiRequest<{ data: unknown[]; page: number; per_page: number }>(\n    `/feeds/${feedId}/posts`,\n    { params: params as Record<string, string | number | boolean | undefined> }\n  );\n}\n\n// --- Posts ---\n\n/**\n * Get a single post by ID.\n * @param postId - The post ID.\n * @returns The post details.\n */\nexport async function getPost(postId: string) {\n  return apiRequest<unknown>(`/posts/${postId}`);\n}\n\n// --- Members ---\n\nexport interface AddMemberInput {\n  email: string;\n  full_name: string;\n  avatar_url_original?: string;\n}\n\n/**\n * Add a new member to the community (Enterprise feature).\n * @param input - Member details including email, name, and optional avatar.\n * @returns The created member details.\n */\nexport async function addMember(input: AddMemberInput) {\n  return apiRequest<unknown>('/members', {\n    method: 'POST',\n    body: input as unknown as Record<string, unknown>,\n    idempotencyKey: crypto.randomUUID()\n  });\n}\n\n/**\n * Check if a user is a member of the community by email.\n * @param email - The email address to check.\n * @returns Membership status and details.\n */\nexport async function checkMembership(email: string) {\n  return apiRequest<unknown>('/members/check', {\n    method: 'POST',\n    body: { email }\n  });\n}\n\n// --- Groups ---\n\nexport interface AddUserToGroupInput {\n  user: { slack_user_id: string } | { email: string } | { profile_id: string };\n}\n\n/**\n * Add a user to a group.\n * @param groupId - The group ID.\n * @param input - User identifier to add to the group.\n * @returns The updated group membership details.\n */\nexport async function addUserToGroup(\n  groupId: string,\n  input: AddUserToGroupInput\n) {\n  return apiRequest<unknown>(`/groups/${groupId}/members`, {\n    method: 'POST',\n    body: input as unknown as Record<string, unknown>,\n    idempotencyKey: crypto.randomUUID()\n  });\n}\n\n// --- Messages ---\n\nexport interface SendMessageInput {\n  channel: string;\n  text: string;\n  thread_ts?: string;\n}\n\n/**\n * Send a message to a Slack channel.\n * @param input - Channel, message text, and optional thread timestamp.\n * @returns The sent message details.\n */\nexport async function sendMessage(input: SendMessageInput) {\n  return apiRequest<unknown>('/messages', {\n    method: 'POST',\n    body: input as unknown as Record<string, unknown>,\n    idempotencyKey: crypto.randomUUID()\n  });\n}\n\n// --- Search ---\n\nexport interface SearchParams {\n  q: string;\n  type: 'post' | 'comment' | 'content_resource';\n  page?: number;\n  per_page?: number;\n}\n\n/**\n * Search across community content (Beta).\n * @param params - Search query, content type, and optional pagination.\n * @returns Paginated search results.\n */\nexport async function search(params: SearchParams) {\n  return apiRequest<{ data: unknown[]; page: number; per_page: number }>(\n    '/search',\n    {\n      params: params as unknown as Record<\n        string,\n        string | number | boolean | undefined\n      >\n    }\n  );\n}\n"],"mappings":"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","names":[]}