@kyrofeedback/sdk 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KyroFeedback
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,243 @@
-# Temporary Holding Version
+# @kyrofeedback/sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A TypeScript-first, server-side client for the KyroFeedback v1 REST API. It uses the existing API and does not connect to a database or depend on Next.js.
+
+The API currently supports feedback listing, retrieval, and creation; comment listing and creation; and vote state, vote, and unvote. Feedback editing/deletion and comment deletion are not available through v1 and are intentionally not exposed here.
+
+## Requirements and installation
+
+- Node.js 20 or newer (native `fetch` and `AbortController`)
+- A KyroFeedback API key for one project
+
+When the package is published, install it with:
+
+```sh
+npm install @kyrofeedback/sdk
+```
+
+This repository does not publish automatically. Until release, build the package and install its packed tarball from a local path.
+
+```sh
+cd packages/sdk
+npm install
+npm test
+npm pack
+# From the consuming application:
+npm install /path/to/kyrofeedback-sdk-0.1.0.tgz
+```
+
+## Keep keys on the server
+
+The SDK can use either `sk_live_` or `pk_live_` keys because both are accepted by these API endpoints. Current keys have the prefix followed by 43 base64url characters. For a server integration, use a secret `sk_live_` key and keep it in a server-only environment variable. In Next.js, use `KYROFEEDBACK_API_KEY`, never `NEXT_PUBLIC_KYROFEEDBACK_API_KEY`. The client rejects initialization in a browser runtime; do not import it into browser components or send a secret key to a browser. The browser widget continues to use its publishable key and `widget.js`.
+
+Keys are project-scoped. The API enforces project settings, project isolation, and a current limit of 120 requests per minute per key. Feedback, comment, and vote creation can return `403` when the corresponding anonymous activity setting is disabled. The SDK does not bypass those checks.
+
+## Initialize
+
+```ts
+import { KyroFeedback } from "@kyrofeedback/sdk";
+
+const kyro = new KyroFeedback({
+  apiKey: process.env.KYROFEEDBACK_API_KEY!,
+});
+```
+
+The default host is `https://feedback.kyrocms.com`; requests go to its `/api/v1` API. For a local or self-hosted instance, set `baseUrl` to its origin (or an origin with a path prefix):
+
+```ts
+const kyro = new KyroFeedback({
+  apiKey: process.env.KYROFEEDBACK_API_KEY!,
+  baseUrl: "http://localhost:3000",
+  timeout: 5_000,
+});
+```
+
+`baseUrl` must be an absolute HTTP or HTTPS URL without credentials, query, or fragment. Plain HTTP is accepted only for localhost and loopback development URLs; remote hosts must use HTTPS. A trailing `/api/v1` is normalized. The default timeout is 10 seconds. Pass a compatible Fetch API implementation with `fetch` when needed.
+
+## Feedback
+
+### List and paginate
+
+The list endpoint returns newest feedback first and supports `limit` (API range 1–50, default 20), `cursor`, `q`, `status`, and `type`. The page object preserves `meta.nextCursor`; request subsequent pages only when needed.
+
+```ts
+const page = await kyro.feedback.list({
+  limit: 20,
+  status: "OPEN",
+  type: "FEATURE",
+  q: "dark mode",
+});
+
+for (const item of page.data) {
+  console.log(item.title, item.votesCount, item.commentsCount);
+}
+
+if (page.meta.nextCursor) {
+  const nextPage = await kyro.feedback.list({
+    limit: 20,
+    cursor: page.meta.nextCursor,
+  });
+}
+```
+
+Supported status values are `OPEN`, `PLANNED`, `IN_PROGRESS`, `COMPLETED`, and `CLOSED`. Supported type values are `FEATURE`, `BUG`, `QUESTION`, and `INTEGRATION`.
+
+### Get and create
+
+```ts
+const item = await kyro.feedback.get("feedback-id");
+
+const created = await kyro.feedback.create({
+  title: "Add dark mode",
+  description: "A dark theme would make the dashboard easier to use at night.",
+  type: "FEATURE",
+  authorName: "Alex", // optional; 100 characters maximum in the API
+});
+```
+
+The API requires a title of 3–200 characters and a description of 3–10,000 characters. Feedback creation is anonymous and requires the project’s anonymous feedback setting to be enabled. The response fields are `id`, `title`, `description`, `type`, `status`, `votesCount`, `commentsCount`, `createdAt`, and `updatedAt`.
+
+The v1 API does not support feedback updates or deletion. Those methods are not included.
+
+## Comments and replies
+
+```ts
+const comments = await kyro.comments.list("feedback-id");
+
+const rootComment = await kyro.comments.create("feedback-id", {
+  content: "This would help our team too.",
+  authorName: "Alex",
+});
+
+await kyro.comments.create("feedback-id", {
+  content: "Thanks for the detail!",
+  parentId: rootComment.id,
+});
+```
+
+Comments are returned as a flat, creation-ordered array. Group `parentId: null` comments as roots and attach replies to their parent ID. The API accepts comment content up to 5,000 characters, requires anonymous comments to be enabled, and validates that a reply’s parent belongs to the same feedback item. Comment deletion is not supported by the v1 API.
+
+## Votes and visitor identity
+
+```ts
+const state = await kyro.votes.get("feedback-id");
+const updated = state.voted
+  ? await kyro.votes.unvote("feedback-id")
+  : await kyro.votes.vote("feedback-id");
+```
+
+The API identifies votes with its `kyro_anonymous_id` cookie; it does not accept a user ID. The SDK never stores cookies between requests because a long-lived server client may be shared by many visitors. To preserve a particular visitor’s identity in a server route, forward that visitor’s Kyro cookie on each request:
+
+```ts
+const cookie = request.headers.get("cookie") ?? undefined;
+const voteState = await kyro.votes.get("feedback-id", { cookie });
+const responseHeaders = new Headers();
+const updated = await kyro.votes.vote("feedback-id", {
+  cookie,
+  onResponse(response) {
+    // In a server route, relay Set-Cookie to that same visitor when present.
+    const setCookie = response.headers.get("set-cookie");
+    if (setCookie) responseHeaders.append("set-cookie", setCookie);
+  },
+});
+return Response.json(updated, { headers: responseHeaders });
+```
+
+`RequestOptions` also accepts an `AbortSignal`. Vote state and counts come from the API response; the SDK does not synthesize them.
+
+## Request controls
+
+All resource methods accept an optional final `RequestOptions` argument with `signal`, `cookie`, and `onResponse`. Cookies are opt-in and never persisted. Mutations are not automatically retried.
+
+```ts
+const controller = new AbortController();
+const result = await kyro.feedback.list({ limit: 10 }, { signal: controller.signal });
+```
+
+## Errors
+
+All API, transport, and malformed-response failures are `KyroFeedbackError` instances. `status` is populated for HTTP responses, and `kind` categorizes failures as `authentication`, `permission`, `validation`, `not_found`, `rate_limit`, `server`, `http`, `network`, `timeout`, or `invalid_response`.
+
+The API currently returns errors as `{ error: { message, status } }`; it does not return a stable error code or request ID, so the SDK does not fabricate either.
+
+```ts
+import { KyroFeedbackError } from "@kyrofeedback/sdk";
+
+try {
+  await kyro.feedback.create({ title: "Add dark mode", description: "Please add a dark theme.", type: "FEATURE" });
+} catch (error) {
+  if (error instanceof KyroFeedbackError) {
+    if (error.kind === "permission") console.error("Check anonymous feedback settings.");
+    else console.error(error.kind, error.status, error.message);
+  }
+  throw error;
+}
+```
+
+## Next.js server-side usage
+
+Keep SDK use in a route handler or server component. A client component should call your route, not import the SDK or receive the secret key.
+
+```ts
+// app/api/feedback/route.ts
+import { KyroFeedback, KyroFeedbackError } from "@kyrofeedback/sdk";
+
+const kyro = new KyroFeedback({ apiKey: process.env.KYROFEEDBACK_API_KEY! });
+
+export async function GET() {
+  try {
+    const page = await kyro.feedback.list({ limit: 20 });
+    return Response.json(page);
+  } catch (error) {
+    if (error instanceof KyroFeedbackError) {
+      return Response.json({ error: error.message }, { status: error.status ?? 502 });
+    }
+    return Response.json({ error: "Unexpected error" }, { status: 500 });
+  }
+}
+```
+
+An end-to-end example is in [`examples/nextjs`](./examples/nextjs).
+
+## Node.js usage
+
+```js
+import { KyroFeedback } from "@kyrofeedback/sdk";
+
+const kyro = new KyroFeedback({ apiKey: process.env.KYROFEEDBACK_API_KEY });
+const page = await kyro.feedback.list({ limit: 10, type: "BUG" });
+console.log(page.data);
+```
+
+## Development, tests, and package verification
+
+From this directory:
+
+```sh
+npm install
+npm run typecheck
+npm test
+npm run pack:check
+```
+
+`npm test` compiles the package and runs mocked-fetch tests with Node’s built-in test runner. It does not contact a live service.
+
+### Live integration checks
+
+`npm run test:integration` runs an opt-in suite against a dedicated local or test deployment. It creates feedback and comments and changes a vote; it cannot delete those records. Use two disposable projects with separate keys, enable anonymous feedback, comments, and voting on the first project, and use a third disposable key that you have revoked if you want the revoked-key case. Never use a production project, key, or user data.
+
+Set these server-side variables without printing or committing them:
+
+```sh
+export KYROFEEDBACK_BASE_URL=http://localhost:3000
+export KYROFEEDBACK_TEST_API_KEY=sk_live_REPLACE_WITH_FULL_TEST_PROJECT_ONE_KEY
+export KYROFEEDBACK_SECOND_PROJECT_API_KEY=sk_live_REPLACE_WITH_FULL_TEST_PROJECT_TWO_KEY
+export KYROFEEDBACK_REVOKED_API_KEY=sk_live_REPLACE_WITH_FULL_REVOKED_TEST_KEY
+npm run test:integration
+```
+
+Replace each placeholder with the complete raw disposable key copied from the dashboard; these sample values are intentionally not valid keys.
+
+For a remote dedicated test host, use HTTPS and explicitly set `KYROFEEDBACK_ALLOW_REMOTE_TEST_INSTANCE=true` after confirming the deployment is isolated. The script refuses `feedback.kyrocms.com` and refuses remote hosts without that opt-in. It checks authentication, list/create/get, cursor pagination, comments/replies, vote/unvote, a second-project 404, invalid credentials, and (when provided) revoked credentials. The test records are marked with a random ID and remain in the disposable project because v1 has no delete methods.
+
+Build output and declaration files are generated under `dist/`. To publish after review, update the version, run the checks above, inspect `npm pack --dry-run`, then publish explicitly from this directory with `npm publish --access public`. No package has been published by this repository change.

package/dist/client.d.ts

@@ -0,0 +1,21 @@
+import type { Comment, CreateCommentInput, CreateFeedbackInput, Feedback, FeedbackPage, KyroFeedbackConfig, ListFeedbackOptions, RequestOptions, VoteState } from "./types.js";
+/** Server-side client for the supported KyroFeedback v1 REST API. */
+export declare class KyroFeedback {
+    private readonly http;
+    readonly feedback: {
+        list: (options?: ListFeedbackOptions, request?: RequestOptions) => Promise<FeedbackPage>;
+        get: (id: string, request?: RequestOptions) => Promise<Feedback>;
+        create: (input: CreateFeedbackInput, request?: RequestOptions) => Promise<Feedback>;
+    };
+    readonly comments: {
+        list: (feedbackId: string, request?: RequestOptions) => Promise<Comment[]>;
+        create: (feedbackId: string, input: CreateCommentInput, request?: RequestOptions) => Promise<Comment>;
+    };
+    readonly votes: {
+        get: (feedbackId: string, request?: RequestOptions) => Promise<VoteState>;
+        vote: (feedbackId: string, request?: RequestOptions) => Promise<VoteState>;
+        unvote: (feedbackId: string, request?: RequestOptions) => Promise<VoteState>;
+    };
+    constructor(config: KyroFeedbackConfig);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,SAAS,EACV,MAAM,YAAY,CAAC;AA4LpB,qEAAqE;AACrE,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC,QAAQ,CAAC,QAAQ,EAAE;QACjB,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;QACzF,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjE,MAAM,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;KACrF,CAAC;IAEF,QAAQ,CAAC,QAAQ,EAAE;QACjB,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3E,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KACvG,CAAC;IAEF,QAAQ,CAAC,KAAK,EAAE;QACd,GAAG,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1E,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;QAC3E,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;KAC9E,CAAC;gBAEU,MAAM,EAAE,kBAAkB;CAiBvC"}

package/dist/client.js

@@ -0,0 +1,210 @@
+import { KyroFeedbackError } from "./errors.js";
+const DEFAULT_BASE_URL = "https://feedback.kyrocms.com";
+const DEFAULT_TIMEOUT = 10_000;
+const API_PATH = "/api/v1";
+function normalizeBaseUrl(value) {
+    const candidate = value ?? DEFAULT_BASE_URL;
+    let url;
+    try {
+        url = new URL(candidate);
+    }
+    catch (cause) {
+        throw new TypeError("baseUrl must be an absolute HTTP or HTTPS URL", { cause });
+    }
+    if (url.protocol !== "https:" && url.protocol !== "http:") {
+        throw new TypeError("baseUrl must use HTTP or HTTPS");
+    }
+    const hostname = url.hostname.toLowerCase();
+    const isLoopback = hostname === "localhost" || hostname.endsWith(".localhost") || hostname === "[::1]"
+        || /^127(?:\.\d{1,3}){3}$/.test(hostname);
+    if (url.protocol === "http:" && !isLoopback) {
+        throw new TypeError("baseUrl must use HTTPS unless it targets localhost or a loopback IP");
+    }
+    if (url.username || url.password || url.search || url.hash) {
+        throw new TypeError("baseUrl must not contain credentials, a query, or a fragment");
+    }
+    const path = url.pathname.replace(/\/+$/, "");
+    if (path.endsWith(API_PATH)) {
+        url.pathname = path.slice(0, -API_PATH.length) || "/";
+    }
+    return url.toString().replace(/\/+$/, "");
+}
+function errorKind(status) {
+    if (status === 401)
+        return "authentication";
+    if (status === 403)
+        return "permission";
+    if (status === 404)
+        return "not_found";
+    if (status === 400 || status === 422)
+        return "validation";
+    if (status === 429)
+        return "rate_limit";
+    if (status >= 500)
+        return "server";
+    return "http";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function sanitizeCause(cause, secret) {
+    if (typeof cause === "string" && cause.includes(secret)) {
+        return cause.split(secret).join("[redacted]");
+    }
+    if (cause instanceof Error && cause.message.includes(secret)) {
+        return new Error(cause.message.split(secret).join("[redacted]"));
+    }
+    return cause;
+}
+function buildQuery(options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit !== undefined)
+        params.set("limit", String(options.limit));
+    if (options.cursor !== undefined)
+        params.set("cursor", options.cursor);
+    if (options.q !== undefined)
+        params.set("q", options.q);
+    if (options.status !== undefined)
+        params.set("status", options.status);
+    if (options.type !== undefined)
+        params.set("type", options.type);
+    const query = params.toString();
+    return query ? `?${query}` : "";
+}
+class HttpClient {
+    baseUrl;
+    #apiKey;
+    timeout;
+    fetcher;
+    constructor(config) {
+        if (typeof window !== "undefined") {
+            throw new TypeError("@kyrofeedback/sdk is server-side only; use widget.js for browser feedback");
+        }
+        if (typeof config.apiKey !== "string" || !config.apiKey.trim()) {
+            throw new TypeError("apiKey is required");
+        }
+        if (!/^(?:sk|pk)_live_[A-Za-z0-9_-]{43}$/.test(config.apiKey)) {
+            throw new TypeError("apiKey must be a 32-byte KyroFeedback key beginning with sk_live_ or pk_live_");
+        }
+        if (config.timeout !== undefined && (!Number.isFinite(config.timeout) || config.timeout <= 0)) {
+            throw new TypeError("timeout must be a positive finite number of milliseconds");
+        }
+        this.#apiKey = config.apiKey;
+        this.baseUrl = normalizeBaseUrl(config.baseUrl);
+        this.timeout = config.timeout ?? DEFAULT_TIMEOUT;
+        this.fetcher = config.fetch ?? globalThis.fetch;
+        if (typeof this.fetcher !== "function") {
+            throw new TypeError("A Fetch API implementation is required; pass it with the fetch option");
+        }
+    }
+    async request(path, init = {}, options = {}, preserveEnvelope = false) {
+        if (options.signal?.aborted) {
+            throw new KyroFeedbackError("KyroFeedback request was aborted", { kind: "network", cause: sanitizeCause(options.signal.reason, this.#apiKey) });
+        }
+        const controller = new AbortController();
+        let timedOut = false;
+        const timeoutId = setTimeout(() => {
+            timedOut = true;
+            controller.abort(new Error("KyroFeedback request timed out"));
+        }, this.timeout);
+        const abortFromCaller = () => controller.abort(options.signal?.reason);
+        if (options.signal?.aborted)
+            abortFromCaller();
+        else
+            options.signal?.addEventListener("abort", abortFromCaller, { once: true });
+        const headers = new Headers({
+            Authorization: `Bearer ${this.#apiKey}`,
+            Accept: "application/json",
+        });
+        if (init.body !== undefined)
+            headers.set("Content-Type", "application/json");
+        if (options.cookie)
+            headers.set("Cookie", options.cookie);
+        let response;
+        try {
+            response = await this.fetcher(`${this.baseUrl}${API_PATH}${path}`, {
+                method: init.method ?? "GET",
+                headers,
+                ...(init.body === undefined ? {} : { body: JSON.stringify(init.body) }),
+                signal: controller.signal,
+            });
+        }
+        catch (cause) {
+            clearTimeout(timeoutId);
+            options.signal?.removeEventListener("abort", abortFromCaller);
+            if (timedOut) {
+                throw new KyroFeedbackError(`KyroFeedback request timed out after ${this.timeout} ms`, { kind: "timeout", cause: sanitizeCause(cause, this.#apiKey) });
+            }
+            if (options.signal?.aborted) {
+                throw new KyroFeedbackError("KyroFeedback request was aborted", { kind: "network", cause: sanitizeCause(cause, this.#apiKey) });
+            }
+            throw new KyroFeedbackError("Unable to reach the KyroFeedback API", { kind: "network", cause: sanitizeCause(cause, this.#apiKey) });
+        }
+        try {
+            options.onResponse?.(response);
+            let payload = null;
+            const text = await response.text().catch((cause) => {
+                if (timedOut) {
+                    throw new KyroFeedbackError(`KyroFeedback request timed out after ${this.timeout} ms`, { kind: "timeout", cause });
+                }
+                if (options.signal?.aborted) {
+                    throw new KyroFeedbackError("KyroFeedback request was aborted", { kind: "network", cause });
+                }
+                throw new KyroFeedbackError("Could not read the KyroFeedback API response", { kind: "invalid_response", cause });
+            });
+            if (text) {
+                try {
+                    payload = JSON.parse(text);
+                }
+                catch (cause) {
+                    if (response.ok) {
+                        throw new KyroFeedbackError("KyroFeedback returned a malformed JSON response", { status: response.status, kind: "invalid_response", cause });
+                    }
+                }
+            }
+            if (!response.ok) {
+                const error = isRecord(payload) && isRecord(payload.error) ? payload.error : undefined;
+                const message = typeof error?.message === "string" ? error.message : `KyroFeedback request failed with HTTP ${response.status}`;
+                const safeMessage = message.split(this.#apiKey).join("[redacted]");
+                throw new KyroFeedbackError(safeMessage, { status: response.status, kind: errorKind(response.status) });
+            }
+            if (!isRecord(payload) || !Object.hasOwn(payload, "data")) {
+                throw new KyroFeedbackError("KyroFeedback returned an unexpected response format", { status: response.status, kind: "invalid_response" });
+            }
+            if (preserveEnvelope && (!isRecord(payload.meta)
+                || !(payload.meta.nextCursor === null || typeof payload.meta.nextCursor === "string"))) {
+                throw new KyroFeedbackError("KyroFeedback returned an unexpected pagination format", { status: response.status, kind: "invalid_response" });
+            }
+            return preserveEnvelope ? payload : payload.data;
+        }
+        finally {
+            clearTimeout(timeoutId);
+            options.signal?.removeEventListener("abort", abortFromCaller);
+        }
+    }
+}
+/** Server-side client for the supported KyroFeedback v1 REST API. */
+export class KyroFeedback {
+    http;
+    feedback;
+    comments;
+    votes;
+    constructor(config) {
+        this.http = new HttpClient(config);
+        this.feedback = {
+            list: (options = {}, request) => this.http.request(`/feedback${buildQuery(options)}`, {}, request, true),
+            get: (id, request) => this.http.request(`/feedback/${encodeURIComponent(id)}`, {}, request),
+            create: (input, request) => this.http.request("/feedback", { method: "POST", body: input }, request),
+        };
+        this.comments = {
+            list: (feedbackId, request) => this.http.request(`/feedback/${encodeURIComponent(feedbackId)}/comments`, {}, request),
+            create: (feedbackId, input, request) => this.http.request(`/feedback/${encodeURIComponent(feedbackId)}/comments`, { method: "POST", body: input }, request),
+        };
+        this.votes = {
+            get: (feedbackId, request) => this.http.request(`/feedback/${encodeURIComponent(feedbackId)}/votes`, {}, request),
+            vote: (feedbackId, request) => this.http.request(`/feedback/${encodeURIComponent(feedbackId)}/votes`, { method: "POST" }, request),
+            unvote: (feedbackId, request) => this.http.request(`/feedback/${encodeURIComponent(feedbackId)}/votes`, { method: "DELETE" }, request),
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+export type KyroFeedbackErrorKind = "authentication" | "permission" | "validation" | "not_found" | "rate_limit" | "server" | "http" | "network" | "timeout" | "invalid_response";
+export interface KyroFeedbackErrorOptions {
+    status?: number;
+    kind: KyroFeedbackErrorKind;
+    cause?: unknown;
+}
+/** Error raised for API failures, network failures, and invalid API responses. */
+export declare class KyroFeedbackError extends Error {
+    readonly status?: number;
+    readonly kind: KyroFeedbackErrorKind;
+    constructor(message: string, options: KyroFeedbackErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,MAAM,GACN,SAAS,GACT,SAAS,GACT,kBAAkB,CAAC;AAEvB,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,kFAAkF;AAClF,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;gBAEzB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB;CAM/D"}

package/dist/errors.js

@@ -0,0 +1,12 @@
+/** Error raised for API failures, network failures, and invalid API responses. */
+export class KyroFeedbackError extends Error {
+    status;
+    kind;
+    constructor(message, options) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = "KyroFeedbackError";
+        this.status = options.status;
+        this.kind = options.kind;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAkBA,kFAAkF;AAClF,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,MAAM,CAAU;IAChB,IAAI,CAAwB;IAErC,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { KyroFeedback } from "./client.js";
+export { KyroFeedbackError } from "./errors.js";
+export type { KyroFeedbackErrorKind, KyroFeedbackErrorOptions } from "./errors.js";
+export type { Comment, CreateCommentInput, CreateFeedbackInput, Feedback, FeedbackPage, FeedbackStatus, FeedbackType, KyroFeedbackConfig, ListFeedbackOptions, RequestOptions, VoteState, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACnF,YAAY,EACV,OAAO,EACP,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { KyroFeedback } from "./client.js";
+export { KyroFeedbackError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+export type FeedbackStatus = "OPEN" | "PLANNED" | "IN_PROGRESS" | "COMPLETED" | "CLOSED";
+export type FeedbackType = "FEATURE" | "BUG" | "QUESTION" | "INTEGRATION";
+/** A feedback object returned by the public v1 API. Dates are ISO 8601 strings. */
+export interface Feedback {
+    id: string;
+    title: string;
+    description: string;
+    type: FeedbackType;
+    status: FeedbackStatus;
+    votesCount: number;
+    commentsCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateFeedbackInput {
+    title: string;
+    description: string;
+    type: FeedbackType;
+    authorName?: string;
+}
+export interface ListFeedbackOptions {
+    /** API range is 1–50; omitted values use the API default of 20. */
+    limit?: number;
+    /** Cursor returned as `meta.nextCursor` by the preceding page. */
+    cursor?: string;
+    /** Case-insensitive search across title and description. */
+    q?: string;
+    status?: FeedbackStatus;
+    type?: FeedbackType;
+}
+export interface FeedbackPage {
+    data: Feedback[];
+    meta: {
+        nextCursor: string | null;
+    };
+}
+export interface Comment {
+    id: string;
+    parentId: string | null;
+    content: string;
+    anonymous: boolean;
+    authorName: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateCommentInput {
+    content: string;
+    /** Set to a comment on this same feedback item to create a threaded reply. */
+    parentId?: string | null;
+    authorName?: string;
+}
+export interface VoteState {
+    voted: boolean;
+    count: number;
+}
+export interface KyroFeedbackConfig {
+    /** A project-scoped `sk_live_` or `pk_live_` key. Prefer `sk_live_` on servers. */
+    apiKey: string;
+    /** KyroFeedback origin. Defaults to https://feedback.kyrocms.com. */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. Defaults to 10 seconds. */
+    timeout?: number;
+    /** Custom Fetch API implementation, useful for runtimes and tests. */
+    fetch?: typeof fetch;
+}
+/** Per-request transport controls. Cookies are never stored by the SDK. */
+export interface RequestOptions {
+    signal?: AbortSignal;
+    /** Forward a visitor's `kyro_anonymous_id` cookie when preserving vote identity. */
+    cookie?: string;
+    /** Inspect response headers, for example to relay Set-Cookie from your server route. */
+    onResponse?: (response: Response) => void;
+}
+//# 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":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;AACzF,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,aAAa,CAAC;AAE1E,mFAAmF;AACnF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACrC;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC3C"}

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/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@kyrofeedback/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "license": "MIT",
+  "description": "Typed server-side client for the KyroFeedback REST API",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kasimthecoder/kyrofeedback.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/kasimthecoder/kyrofeedback/issues"
+  },
+  "homepage": "https://github.com/kasimthecoder/kyrofeedback/tree/main/packages/sdk#readme",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "test:integration": "npm run build && node test/integration.mjs",
+    "pack:check": "npm pack --dry-run"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}