@sayrio/public 0.0.5

package/README.md

@@ -0,0 +1,264 @@
+# @sayrio/public
+
+Public JavaScript & TypeScript SDK for **Sayr.io**.  
+Provides **read‑only access** to Sayr organizations, tasks, comments, and
+real‑time updates via WebSockets.
+
+- ✅ REST + WebSocket
+- ✅ Browser‑safe
+- ✅ TypeScript first
+- ✅ Zero runtime dependencies
+- ✅ Versioned API (`v1`)
+
+> React hooks are available via the **`@sayrio/public/react`** sub‑path export.
+
+---
+
+## Installation
+
+```bash
+npm install @sayrio/public
+```
+
+or
+
+```bash
+pnpm add @sayrio/public
+```
+
+---
+
+## Usage
+
+### Basic Usage (REST)
+
+Fetch public organization data.
+
+`Sayr.org` is an alias for the current API version (`v1`):
+
+```ts
+import Sayr from "@sayrio/public";
+
+const org = await Sayr.org.get("acme");
+
+console.log(org.name);
+```
+
+You can also use the versioned API explicitly:
+
+```ts
+const org = await Sayr.v1.org.get("acme");
+```
+
+---
+
+### Listing Tasks
+
+Retrieve tasks for an organization:
+
+```ts
+const { data: tasks } = await Sayr.org.tasks.list("acme", {
+  order: "desc",
+  limit: 10
+});
+
+console.log(tasks);
+```
+
+---
+
+### Fetching a Single Task
+
+```ts
+const task = await Sayr.org.tasks.get("acme", 42);
+
+console.log(task.title);
+```
+
+---
+
+### Task Comments
+
+Fetch comments for a specific task:
+
+```ts
+const { data: comments } =
+  await Sayr.org.comments.list("acme", 42);
+
+console.log(comments);
+```
+
+---
+
+### Labels & Categories
+
+```ts
+const labels = await Sayr.org.labels.list("acme");
+const categories = await Sayr.org.categories.list("acme");
+```
+
+---
+
+## Authenticated User (`/me`)
+
+The `/me` namespace provides **read‑only access** to the currently
+authenticated user.
+
+> Authentication is required.  
+> Set a token using `Sayr.client.setToken(...)`.
+
+---
+
+### Fetch Current User
+
+```ts
+Sayr.client.setToken(token);
+
+const me = await Sayr.me.get();
+
+console.log(me.email);
+```
+
+---
+
+### List Your Organizations
+
+```ts
+const orgs = await Sayr.me.organizations();
+
+console.log(orgs);
+```
+
+---
+
+## Real‑Time Updates (WebSocket)
+
+Subscribe to public real‑time events using WebSockets:
+
+```ts
+Sayr.ws(org.wsUrl, {
+  [Sayr.WS_EVENTS.UPDATE_TASK]: (task) => {
+    console.log("Task updated", task);
+  }
+});
+```
+
+### WebSocket Features
+
+- Automatic reconnection
+- Heartbeat support (PING / PONG)
+- Typed event constants
+- Public‑safe payloads only
+
+---
+
+## Browser Usage (No Bundler)
+
+```html
+<script type="module">
+  import Sayr from "https://esm.sh/@sayrio/public";
+
+  const org = await Sayr.org.get("acme");
+  console.log(org);
+</script>
+```
+
+---
+
+## API
+
+### `Sayr.org` (latest)
+
+Alias for `Sayr.v1.org`.
+
+#### Organization
+
+| Method      | Description                 |
+| ----------- | --------------------------- |
+| `get(slug)` | Fetch a public organization |
+
+---
+
+#### Tasks
+
+| Method                      | Description            |
+| --------------------------- | ---------------------- |
+| `tasks.list(slug, opts?)`   | List tasks (paginated) |
+| `tasks.get(slug, shortId)`  | Fetch a single task    |
+
+---
+
+#### Comments
+
+| Method                                | Description        |
+| ------------------------------------- | ------------------ |
+| `comments.list(slug, shortId, opts?)` | List task comments |
+
+---
+
+#### Labels
+
+| Method              | Description              |
+| ------------------- | ------------------------ |
+| `labels.list(slug)` | List organization labels |
+
+---
+
+#### Categories
+
+| Method                         | Description     |
+| ------------------------------ | --------------- |
+| `categories.list(slug, order?)` | List categories |
+
+---
+
+### `Sayr.me`
+
+Authenticated user endpoints.
+
+| Method              | Description                            |
+| ------------------- | -------------------------------------- |
+| `get()`             | Fetch the current authenticated user   |
+| `organizations()`   | List organizations the user belongs to |
+
+---
+
+### `Sayr.ws(url, handlers)`
+
+Create a WebSocket connection for public events:
+
+```ts
+const conn = Sayr.ws(wsUrl, {
+  UPDATE_TASK: () => {}
+});
+
+conn.close();
+```
+
+---
+
+### `WS_EVENTS`
+
+Typed WebSocket event constants:
+
+```ts
+Sayr.WS_EVENTS.UPDATE_TASK;
+Sayr.WS_EVENTS.UPDATE_ORG;
+Sayr.WS_EVENTS.ERROR;
+```
+
+---
+
+## TypeScript
+
+This package ships with full TypeScript definitions:
+
+```ts
+import type {
+  Organization,
+  Task,
+  Comment
+} from "@sayrio/public";
+```
+
+---

package/dist/index.cjs

@@ -0,0 +1,356 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SayrClient: () => SayrClient,
+  SayrV1: () => SayrV1,
+  SayrWS: () => SayrWS,
+  SayrWSEvents: () => SayrWSEvents,
+  WS_EVENTS: () => WS_EVENTS,
+  buildPaginationParams: () => buildPaginationParams,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client/index.ts
+var DEFAULT_API = "https://api.sayr.io";
+var config = {
+  fetch: globalThis.fetch,
+  baseUrl: DEFAULT_API
+};
+var hooks = {};
+function setToken(token) {
+  config.token = token;
+}
+function setHeaders(headers) {
+  config.headers = {
+    ...config.headers,
+    ...headers
+  };
+}
+function setFetch(fn) {
+  config.fetch = fn;
+}
+function setBaseUrl(url) {
+  config.baseUrl = url.replace(/\/$/, "");
+}
+function setHooks(h) {
+  Object.assign(hooks, h);
+}
+function resetClient() {
+  config.token = void 0;
+  config.headers = void 0;
+  config.baseUrl = DEFAULT_API;
+}
+async function request(path, opts = {}) {
+  const url = path.startsWith("http") ? path : `${config.baseUrl}${path}`;
+  hooks.onRequest?.(url, opts);
+  let res;
+  try {
+    res = await config.fetch(url, {
+      method: opts.method ?? "GET",
+      headers: {
+        ...config.token ? { Authorization: `Bearer ${config.token}` } : {},
+        ...opts.body ? { "Content-Type": "application/json" } : {},
+        ...config.headers,
+        ...opts.headers
+      },
+      body: opts.body ? JSON.stringify(opts.body) : void 0,
+      signal: opts.signal
+    });
+  } catch (err) {
+    const error = {
+      success: false,
+      error: "NETWORK_ERROR",
+      message: "Failed to reach Sayr API"
+    };
+    hooks.onError?.(error);
+    throw error;
+  }
+  hooks.onResponse?.(res);
+  let json;
+  try {
+    json = await res.json();
+  } catch {
+    const error = {
+      success: false,
+      error: "INVALID_RESPONSE",
+      message: "Server returned invalid JSON",
+      status: res.status
+    };
+    hooks.onError?.(error);
+    throw error;
+  }
+  if (!res.ok || !json.success) {
+    const error = {
+      ...json,
+      success: false,
+      status: res.status
+    };
+    hooks.onError?.(error);
+    throw error;
+  }
+  return json;
+}
+
+// src/api/v1/org/org.ts
+var org_default = {
+  /**
+   * Fetches a public organization by slug.
+   *
+   * @since v1.0.0
+   */
+  async get(slug, opts) {
+    const r = await request(
+      `/v1/organization/${slug}`,
+      opts
+    );
+    return r.data;
+  }
+};
+
+// src/shared/index.ts
+function buildPaginationParams(params) {
+  return new URLSearchParams({
+    order: params?.order ?? "desc",
+    limit: String(params?.limit ?? 5),
+    page: String(params?.page ?? 1)
+  });
+}
+
+// src/api/v1/org/tasks.ts
+var tasks_default = {
+  /**
+   * Lists public tasks for an organization.
+   *
+   * @since v1.0.0
+   */
+  async list(slug, params, opts) {
+    const q = buildPaginationParams(params);
+    const r = await request(
+      `/v1/organization/${slug}/tasks?${q}`,
+      opts
+    );
+    return {
+      data: r.data,
+      pagination: r.pagination
+    };
+  },
+  /**
+   * Fetches a single public task by short ID.
+   *
+   * @since v1.0.0
+   */
+  async get(slug, shortId, opts) {
+    const r = await request(
+      `/v1/organization/${slug}/tasks/${shortId}`,
+      opts
+    );
+    return r.data;
+  }
+};
+
+// src/api/v1/org/comments.ts
+var comments_default = {
+  /**
+   * Lists public comments for a task.
+   *
+   * @since v1.0.0
+   */
+  async list(slug, shortId, params, opts) {
+    const q = buildPaginationParams(params);
+    const r = await request(
+      `/v1/organization/${slug}/tasks/${shortId}/comments?${q}`,
+      opts
+    );
+    return {
+      data: r.data,
+      pagination: r.pagination
+    };
+  }
+};
+
+// src/api/v1/org/labels.ts
+var labels_default = {
+  /**
+   * Lists public labels for an organization.
+   *
+   * @since v1.0.0
+   */
+  async list(slug, opts) {
+    const r = await request(
+      `/v1/organization/${slug}/labels`,
+      opts
+    );
+    return r.data;
+  }
+};
+
+// src/api/v1/org/categories.ts
+var categories_default = {
+  /**
+   * Lists public categories for an organization.
+   *
+   * @since v1.0.0
+   */
+  async list(slug, order = "desc", opts) {
+    const r = await request(
+      `/v1/organization/${slug}/categories?order=${order}`,
+      opts
+    );
+    return r.data;
+  }
+};
+
+// src/api/v1/org/index.ts
+var OrgAPI = {
+  ...org_default,
+  tasks: tasks_default,
+  comments: comments_default,
+  labels: labels_default,
+  categories: categories_default
+};
+var org_default2 = OrgAPI;
+
+// src/api/v1/me/index.ts
+var me_default = {
+  /**
+   * Fetches the currently authenticated user.
+   *
+   * @since v1.0.0
+   */
+  async get(opts) {
+    const r = await request(
+      "/me",
+      opts
+    );
+    return r.data;
+  },
+  /**
+   * Lists organizations the current user belongs to.
+   *
+   * @since v1.0.0
+   */
+  async organizations(opts) {
+    const r = await request(
+      "/organizations",
+      opts
+    );
+    return r.data;
+  }
+};
+
+// src/api/v1/index.ts
+var v1 = {
+  org: org_default2,
+  me: me_default
+};
+var v1_default = v1;
+
+// src/ws/types.ts
+var WS_EVENTS = {
+  CONNECTION_STATUS: "CONNECTION_STATUS",
+  SUBSCRIBED: "SUBSCRIBED",
+  ERROR: "ERROR",
+  PING: "PING",
+  PONG: "PONG",
+  UPDATE_ORG: "UPDATE_ORG",
+  CREATE_TASK: "CREATE_TASK",
+  UPDATE_TASK: "UPDATE_TASK",
+  UPDATE_TASK_COMMENTS: "UPDATE_TASK_COMMENTS",
+  UPDATE_TASK_VOTE: "UPDATE_TASK_VOTE",
+  UPDATE_LABELS: "UPDATE_LABELS",
+  UPDATE_VIEWS: "UPDATE_VIEWS",
+  UPDATE_CATEGORIES: "UPDATE_CATEGORIES",
+  UPDATE_ISSUE_TEMPLATES: "UPDATE_ISSUE_TEMPLATES",
+  DISCONNECTED: "DISCONNECTED"
+};
+
+// src/ws/index.ts
+function ws(url, handlers = {}) {
+  if (!url) {
+    throw new Error(
+      "[Sayr.ws] WebSocket URL is required. Did you forget to pass org.wsUrl?"
+    );
+  }
+  let socket;
+  let retry = 0;
+  let closed = false;
+  function connect() {
+    if (closed) return;
+    socket = new WebSocket(url);
+    socket.onmessage = (e) => {
+      const msg = JSON.parse(e.data);
+      if (msg.type === WS_EVENTS.PING) {
+        socket.send(JSON.stringify({ type: WS_EVENTS.PONG }));
+        return;
+      }
+      handlers[msg.type]?.(msg.data, msg);
+    };
+    socket.onclose = () => {
+      if (closed) return;
+      setTimeout(connect, Math.min(1e3 * 2 ** retry++, 3e4));
+    };
+    socket.onerror = () => socket.close();
+  }
+  connect();
+  return {
+    close() {
+      closed = true;
+      socket?.close();
+    }
+  };
+}
+
+// src/index.ts
+var SayrV1 = v1_default;
+var SayrWS = ws;
+var SayrWSEvents = WS_EVENTS;
+var SayrClient = {
+  setToken,
+  setHeaders,
+  setBaseUrl,
+  resetClient,
+  setHooks,
+  setFetch
+};
+var Sayr = {
+  // client configuration
+  client: SayrClient,
+  // APIs
+  v1: v1_default,
+  org: v1_default.org,
+  me: v1_default.me,
+  // realtime
+  ws,
+  WS_EVENTS
+};
+var index_default = Sayr;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SayrClient,
+  SayrV1,
+  SayrWS,
+  SayrWSEvents,
+  WS_EVENTS,
+  buildPaginationParams
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client/index.ts","../src/api/v1/org/org.ts","../src/shared/index.ts","../src/api/v1/org/tasks.ts","../src/api/v1/org/comments.ts","../src/api/v1/org/labels.ts","../src/api/v1/org/categories.ts","../src/api/v1/org/index.ts","../src/api/v1/me/index.ts","../src/api/v1/index.ts","../src/ws/types.ts","../src/ws/index.ts"],"sourcesContent":["/* ────────────────────────────\r\n   API versions\r\n──────────────────────────── */\r\nimport v1 from \"./api/v1\";\r\n\r\n/* ────────────────────────────\r\n   Realtime\r\n──────────────────────────── */\r\nimport { ws } from \"./ws\";\r\nimport { WS_EVENTS } from \"./ws/types\";\r\n\r\n/* ────────────────────────────\r\n   Client config\r\n──────────────────────────── */\r\nimport {\r\n   setToken,\r\n   setHeaders,\r\n   setBaseUrl,\r\n   resetClient,\r\n   setHooks,\r\n   setFetch\r\n} from \"./client\";\r\n\r\n/* ────────────────────────────\r\n   Named exports (power users)\r\n──────────────────────────── */\r\n\r\n/**\r\n * Sayr Public API — Version 1.\r\n *\r\n * @since v1.0.0\r\n */\r\nexport const SayrV1 = v1;\r\n\r\n\r\n/**\r\n * Create a WebSocket connection for public real‑time updates.\r\n */\r\nexport const SayrWS = ws;\r\n\r\n/**\r\n * Typed WebSocket event constants.\r\n */\r\nexport const SayrWSEvents = WS_EVENTS;\r\n\r\n/**\r\n * Global client configuration helpers.\r\n */\r\nexport const SayrClient = {\r\n   setToken,\r\n   setHeaders,\r\n   setBaseUrl,\r\n   resetClient,\r\n   setHooks,\r\n   setFetch\r\n};\r\n\r\n/* ────────────────────────────\r\n   Default facade\r\n──────────────────────────── */\r\n\r\n/**\r\n * Sayr Public SDK.\r\n *\r\n * Read‑only access to public Sayr data via REST and WebSockets.\r\n *\r\n * @since v1.0.0\r\n */\r\nconst Sayr: {\r\n   /**\r\n    * Client configuration helpers.\r\n    */\r\n   client: typeof SayrClient;\r\n\r\n   /**\r\n    * Versioned API namespaces.\r\n    */\r\n   v1: typeof v1;\r\n\r\n   /**\r\n    * Alias for the current API version (`v1`).\r\n    *\r\n    * @since v1.0.0\r\n    */\r\n   org: typeof v1.org;\r\n   me: typeof v1.me;\r\n\r\n   /**\r\n    * WebSocket helper for real‑time updates.\r\n    */\r\n   ws: typeof ws;\r\n\r\n   /**\r\n    * WebSocket event constants.\r\n    */\r\n   WS_EVENTS: typeof WS_EVENTS;\r\n} = {\r\n   // client configuration\r\n   client: SayrClient,\r\n\r\n   // APIs\r\n   v1,\r\n   org: v1.org,\r\n   me: v1.me,\r\n\r\n   // realtime\r\n   ws,\r\n   WS_EVENTS\r\n};\r\n\r\nexport default Sayr;\r\n\r\n/* ────────────────────────────\r\n   Types & shared helpers\r\n──────────────────────────── */\r\nexport * from \"./types\";\r\nexport * from \"./shared\";\r\nexport * from \"./ws/types\";","import { ApiError } from \"../types\";\r\n\r\n/* ────────────────────────────\r\n   Types\r\n──────────────────────────── */\r\nexport type RequestOptions = {\r\n    method?: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\r\n    headers?: Record<string, string>;\r\n    body?: Record<string, string>;\r\n    signal?: AbortSignal;\r\n};\r\n\r\ntype Hooks = {\r\n    onRequest?: (url: string, opts: RequestOptions) => void;\r\n    onResponse?: (res: Response) => void;\r\n    onError?: (error: ApiError | unknown) => void;\r\n};\r\n\r\ntype ClientConfig = {\r\n    token?: string;\r\n    headers?: Record<string, string>;\r\n    fetch: typeof fetch;\r\n    baseUrl: string;\r\n};\r\n\r\n/* ────────────────────────────\r\n   Internal state\r\n──────────────────────────── */\r\nconst DEFAULT_API = \"https://api.sayr.io\";\r\n\r\nconst config: ClientConfig = {\r\n    fetch: globalThis.fetch,\r\n    baseUrl: DEFAULT_API\r\n};\r\n\r\nconst hooks: Hooks = {};\r\n\r\n/* ────────────────────────────\r\n   Public config API\r\n──────────────────────────── */\r\nexport function setToken(token?: string) {\r\n    config.token = token;\r\n}\r\n\r\nexport function getToken() {\r\n    return config.token;\r\n}\r\n\r\nexport function setHeaders(headers?: Record<string, string>) {\r\n    config.headers = {\r\n        ...config.headers,\r\n        ...headers\r\n    };\r\n}\r\n\r\nexport function setFetch(fn: typeof fetch) {\r\n    config.fetch = fn;\r\n}\r\n\r\nexport function setBaseUrl(url: string) {\r\n    config.baseUrl = url.replace(/\\/$/, \"\");\r\n}\r\n\r\nexport function setHooks(h: Hooks) {\r\n    Object.assign(hooks, h);\r\n}\r\n\r\nexport function resetClient() {\r\n    config.token = undefined;\r\n    config.headers = undefined;\r\n    config.baseUrl = DEFAULT_API;\r\n}\r\n\r\n/* ────────────────────────────\r\n   Request helper\r\n──────────────────────────── */\r\nexport async function request<T>(\r\n    path: string,\r\n    opts: RequestOptions = {}\r\n): Promise<T> {\r\n    const url = path.startsWith(\"http\")\r\n        ? path\r\n        : `${config.baseUrl}${path}`;\r\n\r\n    hooks.onRequest?.(url, opts);\r\n\r\n    let res: Response;\r\n\r\n    try {\r\n        res = await config.fetch(url, {\r\n            method: opts.method ?? \"GET\",\r\n            headers: {\r\n                ...(config.token\r\n                    ? { Authorization: `Bearer ${config.token}` }\r\n                    : {}),\r\n                ...(opts.body\r\n                    ? { \"Content-Type\": \"application/json\" }\r\n                    : {}),\r\n                ...config.headers,\r\n                ...opts.headers\r\n            },\r\n            body: opts.body\r\n                ? JSON.stringify(opts.body)\r\n                : undefined,\r\n            signal: opts.signal\r\n        });\r\n    } catch (err) {\r\n        const error: ApiError = {\r\n            success: false,\r\n            error: \"NETWORK_ERROR\",\r\n            message: \"Failed to reach Sayr API\"\r\n        };\r\n        hooks.onError?.(error);\r\n        throw error;\r\n    }\r\n\r\n    hooks.onResponse?.(res);\r\n\r\n    let json: any;\r\n    try {\r\n        json = await res.json();\r\n    } catch {\r\n        const error: ApiError = {\r\n            success: false,\r\n            error: \"INVALID_RESPONSE\",\r\n            message: \"Server returned invalid JSON\",\r\n            status: res.status\r\n        };\r\n        hooks.onError?.(error);\r\n        throw error;\r\n    }\r\n\r\n    if (!res.ok || !json.success) {\r\n        const error: ApiError = {\r\n            ...json,\r\n            success: false,\r\n            status: res.status\r\n        };\r\n        hooks.onError?.(error);\r\n        throw error;\r\n    }\r\n\r\n    return json;\r\n}","import { Organization, ApiSuccess } from \"../../../types\";\r\nimport { request, type RequestOptions } from \"../../../client\";\r\n\r\n/**\r\n * Organization core operations.\r\n */\r\nexport default {\r\n    /**\r\n     * Fetches a public organization by slug.\r\n     *\r\n     * @since v1.0.0\r\n     */\r\n    async get(\r\n        slug: string,\r\n        opts?: RequestOptions\r\n    ): Promise<Organization> {\r\n        const r = await request<ApiSuccess<Organization>>(\r\n            `/v1/organization/${slug}`,\r\n            opts\r\n        );\r\n        return r.data;\r\n    }\r\n};","/* =======================\r\n * Shared params & helpers\r\n * ======================= */\r\n\r\nexport type Order = \"asc\" | \"desc\";\r\n\r\nexport interface PaginationParams {\r\n    page?: number;\r\n    limit?: number;\r\n}\r\n\r\nexport interface OrderedPaginationParams extends PaginationParams {\r\n    order?: Order;\r\n}\r\n\r\nexport function buildPaginationParams(\r\n    params?: OrderedPaginationParams\r\n): URLSearchParams {\r\n    return new URLSearchParams({\r\n        order: params?.order ?? \"desc\",\r\n        limit: String(params?.limit ?? 5),\r\n        page: String(params?.page ?? 1)\r\n    });\r\n}","import {\r\n    Task,\r\n    Pagination,\r\n    ApiSuccess\r\n} from \"../../../types\";\r\nimport { request, type RequestOptions } from \"../../../client\";\r\nimport {\r\n    type OrderedPaginationParams,\r\n    buildPaginationParams\r\n} from \"../../../shared\";\r\n\r\n/**\r\n * Organization tasks.\r\n */\r\nexport default {\r\n    /**\r\n     * Lists public tasks for an organization.\r\n     *\r\n     * @since v1.0.0\r\n     */\r\n    async list(\r\n        slug: string,\r\n        params?: OrderedPaginationParams,\r\n        opts?: RequestOptions\r\n    ): Promise<{ data: Task[]; pagination: Pagination }> {\r\n        const q = buildPaginationParams(params);\r\n\r\n        const r = await request<\r\n            ApiSuccess<Task[]> & { pagination: Pagination }\r\n        >(\r\n            `/v1/organization/${slug}/tasks?${q}`,\r\n            opts\r\n        );\r\n\r\n        return {\r\n            data: r.data,\r\n            pagination: r.pagination\r\n        };\r\n    },\r\n\r\n    /**\r\n     * Fetches a single public task by short ID.\r\n     *\r\n     * @since v1.0.0\r\n     */\r\n    async get(\r\n        slug: string,\r\n        shortId: number,\r\n        opts?: RequestOptions\r\n    ): Promise<Task> {\r\n        const r = await request<ApiSuccess<Task>>(\r\n            `/v1/organization/${slug}/tasks/${shortId}`,\r\n            opts\r\n        );\r\n        return r.data;\r\n    }\r\n};","import {\r\n    Comment,\r\n    Pagination,\r\n    ApiSuccess\r\n} from \"../../../types\";\r\nimport { request, type RequestOptions } from \"../../../client\";\r\nimport {\r\n    type OrderedPaginationParams,\r\n    buildPaginationParams\r\n} from \"../../../shared\";\r\n\r\n/**\r\n * Organization task comments.\r\n */\r\nexport default {\r\n    /**\r\n     * Lists public comments for a task.\r\n     *\r\n     * @since v1.0.0\r\n     */\r\n    async list(\r\n        slug: string,\r\n        shortId: number,\r\n        params?: OrderedPaginationParams,\r\n        opts?: RequestOptions\r\n    ): Promise<{ data: Comment[]; pagination: Pagination }> {\r\n        const q = buildPaginationParams(params);\r\n\r\n        const r = await request<\r\n            ApiSuccess<Comment[]> & { pagination: Pagination }\r\n        >(\r\n            `/v1/organization/${slug}/tasks/${shortId}/comments?${q}`,\r\n            opts\r\n        );\r\n\r\n        return {\r\n            data: r.data,\r\n            pagination: r.pagination\r\n        };\r\n    }\r\n};","import { Label, ApiSuccess } from \"../../../types\";\r\nimport { request, type RequestOptions } from \"../../../client\";\r\n\r\n/**\r\n * Organization labels.\r\n */\r\nexport default {\r\n    /**\r\n     * Lists public labels for an organization.\r\n     *\r\n     * @since v1.0.0\r\n     */\r\n    async list(\r\n        slug: string,\r\n        opts?: RequestOptions\r\n    ): Promise<Label[]> {\r\n        const r = await request<ApiSuccess<Label[]>>(\r\n            `/v1/organization/${slug}/labels`,\r\n            opts\r\n        );\r\n        return r.data;\r\n    }\r\n};","import {\r\n    Category,\r\n    ApiSuccess\r\n} from \"../../../types\";\r\nimport { request, type RequestOptions } from \"../../../client\";\r\nimport { type Order } from \"../../../shared\";\r\n\r\n/**\r\n * Organization categories.\r\n */\r\nexport default {\r\n    /**\r\n     * Lists public categories for an organization.\r\n     *\r\n     * @since v1.0.0\r\n     */\r\n    async list(\r\n        slug: string,\r\n        order: Order = \"desc\",\r\n        opts?: RequestOptions\r\n    ): Promise<Category[]> {\r\n        const r = await request<ApiSuccess<Category[]>>(\r\n            `/v1/organization/${slug}/categories?order=${order}`,\r\n            opts\r\n        );\r\n        return r.data;\r\n    }\r\n};","import org from \"./org\";\r\nimport tasks from \"./tasks\";\r\nimport comments from \"./comments\";\r\nimport labels from \"./labels\";\r\nimport categories from \"./categories\";\r\n\r\n/**\r\n * Public Sayr Organization API — Version 1.\r\n *\r\n * @since v1.0.0\r\n */\r\nconst OrgAPI = {\r\n    ...org,\r\n    tasks,\r\n    comments,\r\n    labels,\r\n    categories\r\n};\r\n\r\nexport default OrgAPI;","import { request, type RequestOptions } from \"../../../client\";\r\nimport { ApiSuccess, Organization } from \"../../../types\";\r\n\r\nexport interface Me {\r\n    id: string;\r\n    name: string | null;\r\n    email: string | null;\r\n    image: string | null;\r\n    createdAt: string;\r\n}\r\n\r\n/**\r\n * Authenticated user API — Version 1.\r\n *\r\n * @since v1.0.0\r\n */\r\nexport default {\r\n    /**\r\n     * Fetches the currently authenticated user.\r\n     *\r\n     * @since v1.0.0\r\n     */\r\n    async get(opts?: RequestOptions): Promise<Me> {\r\n        const r = await request<ApiSuccess<Me>>(\r\n            \"/me\",\r\n            opts\r\n        );\r\n        return r.data;\r\n    },\r\n\r\n    /**\r\n     * Lists organizations the current user belongs to.\r\n     *\r\n     * @since v1.0.0\r\n     */\r\n    async organizations(\r\n        opts?: RequestOptions\r\n    ): Promise<Organization[]> {\r\n        const r = await request<ApiSuccess<Organization[]>>(\r\n            \"/organizations\",\r\n            opts\r\n        );\r\n        return r.data;\r\n    }\r\n};","import org from \"./org\";\r\nimport me from \"./me\";\r\nexport const v1 = {\r\n    org,\r\n    me\r\n};\r\n\r\nexport default v1;","export type WSMessageType =\r\n    | \"CONNECTION_STATUS\"\r\n    | \"SUBSCRIBED\"\r\n    | \"ERROR\"\r\n    | \"PING\"\r\n    | \"PONG\"\r\n    | \"UPDATE_ORG\"\r\n    | \"CREATE_TASK\"\r\n    | \"UPDATE_TASK\"\r\n    | \"UPDATE_TASK_COMMENTS\"\r\n    | \"UPDATE_TASK_VOTE\"\r\n    | \"UPDATE_LABELS\"\r\n    | \"UPDATE_VIEWS\"\r\n    | \"UPDATE_CATEGORIES\"\r\n    | \"UPDATE_ISSUE_TEMPLATES\"\r\n    | \"DISCONNECTED\";\r\n\r\n/**\r\n * String enum replacement for WS event names.\r\n * Use this instead of raw strings.\r\n */\r\nexport const WS_EVENTS: Record<WSMessageType, WSMessageType> = {\r\n    CONNECTION_STATUS: \"CONNECTION_STATUS\",\r\n    SUBSCRIBED: \"SUBSCRIBED\",\r\n    ERROR: \"ERROR\",\r\n    PING: \"PING\",\r\n    PONG: \"PONG\",\r\n    UPDATE_ORG: \"UPDATE_ORG\",\r\n    CREATE_TASK: \"CREATE_TASK\",\r\n    UPDATE_TASK: \"UPDATE_TASK\",\r\n    UPDATE_TASK_COMMENTS: \"UPDATE_TASK_COMMENTS\",\r\n    UPDATE_TASK_VOTE: \"UPDATE_TASK_VOTE\",\r\n    UPDATE_LABELS: \"UPDATE_LABELS\",\r\n    UPDATE_VIEWS: \"UPDATE_VIEWS\",\r\n    UPDATE_CATEGORIES: \"UPDATE_CATEGORIES\",\r\n    UPDATE_ISSUE_TEMPLATES: \"UPDATE_ISSUE_TEMPLATES\",\r\n    DISCONNECTED: \"DISCONNECTED\"\r\n};\r\n\r\nexport interface WSMessage<T = unknown> {\r\n    type: WSMessageType;\r\n    scope: \"PUBLIC\";\r\n    data: T;\r\n    meta?: { ts: number };\r\n}","import { WS_EVENTS, type WSMessage, type WSMessageType } from \"./types\";\r\n\r\ntype Handlers = Partial<\r\n    Record<WSMessageType, (data: any, msg: WSMessage) => void>\r\n>;\r\n\r\nexport function ws(url: string, handlers: Handlers = {}) {\r\n    if (!url) {\r\n        throw new Error(\r\n            \"[Sayr.ws] WebSocket URL is required. \" +\r\n            \"Did you forget to pass org.wsUrl?\"\r\n        );\r\n    }\r\n    let socket: WebSocket;\r\n    let retry = 0;\r\n    let closed = false;\r\n\r\n    function connect() {\r\n        if (closed) return;\r\n\r\n        socket = new WebSocket(url);\r\n\r\n        socket.onmessage = (e) => {\r\n            const msg = JSON.parse(e.data) as WSMessage;\r\n\r\n            if (msg.type === WS_EVENTS.PING) {\r\n                socket.send(JSON.stringify({ type: WS_EVENTS.PONG }));\r\n                return;\r\n            }\r\n\r\n            handlers[msg.type]?.(msg.data, msg);\r\n        };\r\n\r\n        socket.onclose = () => {\r\n            if (closed) return;\r\n            setTimeout(connect, Math.min(1000 * 2 ** retry++, 30000));\r\n        };\r\n\r\n        socket.onerror = () => socket.close();\r\n    }\r\n\r\n    connect();\r\n\r\n    return {\r\n        close() {\r\n            closed = true;\r\n            socket?.close();\r\n        }\r\n    };\r\n}"],"mappings":"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","names":["org_default","org_default"]}