@groupwisdom/sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,65 @@
+const DEFAULT_BASE_URL = "https://groupwisdom.up.railway.app";
+class GroupWisdom {
+    constructor(options) {
+        if (!options.apiKey)
+            throw new Error("GroupWisdom: apiKey is required.");
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    }
+    async request(method, path, body) {
+        const res = await fetch(`${this.baseUrl}/v1${path}`, {
+            method,
+            headers: {
+                "Authorization": `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+        const data = await res.json();
+        if (!res.ok) {
+            throw new Error(`GroupWisdom API error ${res.status}: ${data?.error ?? res.statusText}`);
+        }
+        return data;
+    }
+    // ── Projects ────────────────────────────────────────────────────────────────
+    /** Create a new project. */
+    createProject(name, options) {
+        return this.request("POST", "/projects", { name, ...options });
+    }
+    /** List all projects you have access to. */
+    listProjects() {
+        return this.request("GET", "/projects");
+    }
+    /** Get a single project by ID. */
+    getProject(projectId) {
+        return this.request("GET", `/projects/${projectId}`);
+    }
+    /** Update a project's webhook URL. */
+    updateProject(projectId, updates) {
+        return this.request("PATCH", `/projects/${projectId}`, updates);
+    }
+    // ── Ingest ──────────────────────────────────────────────────────────────────
+    /**
+     * Send one or more items to a project. Triggers analysis automatically.
+     * Items can include contributed_by to attribute them to a specific person.
+     */
+    ingest(projectId, items) {
+        const payload = Array.isArray(items) ? { items } : items;
+        return this.request("POST", `/projects/${projectId}/ingest`, payload);
+    }
+    // ── Read ────────────────────────────────────────────────────────────────────
+    /** List all items in a project. */
+    listItems(projectId) {
+        return this.request("GET", `/projects/${projectId}/items`);
+    }
+    /**
+     * Get insights for a project.
+     * Optionally filter by kind: connection | blind_spot | conflict | pattern | question | decision
+     */
+    listInsights(projectId, kind) {
+        const qs = kind ? `?kind=${kind}` : "";
+        return this.request("GET", `/projects/${projectId}/insights${qs}`);
+    }
+}
+module.exports = GroupWisdom;
+//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+export interface GroupWisdomOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+export interface Project {
+    id: string;
+    name: string;
+    created_at: string;
+    webhook_url: string | null;
+    counts: {
+        items: number;
+        insights: number;
+    };
+}
+export interface IngestItem {
+    title?: string;
+    content?: string;
+    url?: string;
+    type?: "link" | "note" | "file" | "thought";
+    contributed_by?: string;
+}
+export interface IngestResponse {
+    accepted: number;
+    items: Array<{
+        id: string;
+        title: string;
+        type: string;
+    }>;
+    message: string;
+}
+export interface Item {
+    id: string;
+    group_id: string;
+    member_id: string | null;
+    type: string;
+    title: string;
+    content: string;
+    url: string;
+    source: string;
+    created_at: string;
+}
+export interface Insight {
+    id: string;
+    group_id: string;
+    kind: "connection" | "blind_spot" | "conflict" | "pattern" | "question" | "decision";
+    title: string;
+    body: string;
+    status: string;
+    created_at: string;
+}
+export type InsightKind = Insight["kind"];
+declare class GroupWisdom {
+    private apiKey;
+    private baseUrl;
+    constructor(options: GroupWisdomOptions);
+    private request;
+    /** Create a new project. */
+    createProject(name: string, options?: {
+        webhook_url?: string;
+    }): Promise<Project>;
+    /** List all projects you have access to. */
+    listProjects(): Promise<Project[]>;
+    /** Get a single project by ID. */
+    getProject(projectId: string): Promise<Project>;
+    /** Update a project's webhook URL. */
+    updateProject(projectId: string, updates: {
+        webhook_url?: string | null;
+    }): Promise<Project>;
+    /**
+     * Send one or more items to a project. Triggers analysis automatically.
+     * Items can include contributed_by to attribute them to a specific person.
+     */
+    ingest(projectId: string, items: IngestItem | IngestItem[]): Promise<IngestResponse>;
+    /** List all items in a project. */
+    listItems(projectId: string): Promise<Item[]>;
+    /**
+     * Get insights for a project.
+     * Optionally filter by kind: connection | blind_spot | conflict | pattern | question | decision
+     */
+    listInsights(projectId: string, kind?: InsightKind): Promise<Insight[]>;
+}
+export default GroupWisdom;
+//# 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":"AAEA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE1C,cAAM,WAAW;IACf,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,kBAAkB;YAMzB,OAAO;IAqBrB,4BAA4B;IAC5B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjF,4CAA4C;IAC5C,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIlC,kCAAkC;IAClC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/C,sCAAsC;IACtC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5F;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAOpF,mCAAmC;IACnC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAI7C;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAIxE;AAED,eAAe,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,65 @@
+const DEFAULT_BASE_URL = "https://groupwisdom.up.railway.app";
+class GroupWisdom {
+    constructor(options) {
+        if (!options.apiKey)
+            throw new Error("GroupWisdom: apiKey is required.");
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    }
+    async request(method, path, body) {
+        const res = await fetch(`${this.baseUrl}/v1${path}`, {
+            method,
+            headers: {
+                "Authorization": `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+        const data = await res.json();
+        if (!res.ok) {
+            throw new Error(`GroupWisdom API error ${res.status}: ${data?.error ?? res.statusText}`);
+        }
+        return data;
+    }
+    // ── Projects ────────────────────────────────────────────────────────────────
+    /** Create a new project. */
+    createProject(name, options) {
+        return this.request("POST", "/projects", { name, ...options });
+    }
+    /** List all projects you have access to. */
+    listProjects() {
+        return this.request("GET", "/projects");
+    }
+    /** Get a single project by ID. */
+    getProject(projectId) {
+        return this.request("GET", `/projects/${projectId}`);
+    }
+    /** Update a project's webhook URL. */
+    updateProject(projectId, updates) {
+        return this.request("PATCH", `/projects/${projectId}`, updates);
+    }
+    // ── Ingest ──────────────────────────────────────────────────────────────────
+    /**
+     * Send one or more items to a project. Triggers analysis automatically.
+     * Items can include contributed_by to attribute them to a specific person.
+     */
+    ingest(projectId, items) {
+        const payload = Array.isArray(items) ? { items } : items;
+        return this.request("POST", `/projects/${projectId}/ingest`, payload);
+    }
+    // ── Read ────────────────────────────────────────────────────────────────────
+    /** List all items in a project. */
+    listItems(projectId) {
+        return this.request("GET", `/projects/${projectId}/items`);
+    }
+    /**
+     * Get insights for a project.
+     * Optionally filter by kind: connection | blind_spot | conflict | pattern | question | decision
+     */
+    listInsights(projectId, kind) {
+        const qs = kind ? `?kind=${kind}` : "";
+        return this.request("GET", `/projects/${projectId}/insights${qs}`);
+    }
+}
+export default GroupWisdom;
+//# 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,MAAM,gBAAgB,GAAG,oCAAoC,CAAC;AAqD9D,MAAM,WAAW;IAIf,YAAY,OAA2B;QACrC,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,OAAO,CAAI,MAAc,EAAE,IAAY,EAAE,IAAc;QACnE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,MAAM,IAAI,EAAE,EAAE;YACnD,MAAM;YACN,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACxC,cAAc,EAAE,kBAAkB;aACnC;YACD,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAS,CAAC;QAErC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3F,CAAC;QAED,OAAO,IAAS,CAAC;IACnB,CAAC;IAED,+EAA+E;IAE/E,4BAA4B;IAC5B,aAAa,CAAC,IAAY,EAAE,OAAkC;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,4CAA4C;IAC5C,YAAY;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED,kCAAkC;IAClC,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,SAAS,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,sCAAsC;IACtC,aAAa,CAAC,SAAiB,EAAE,OAAwC;QACvE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED,+EAA+E;IAE/E;;;OAGG;IACH,MAAM,CAAC,SAAiB,EAAE,KAAgC;QACxD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,SAAS,SAAS,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAED,+EAA+E;IAE/E,mCAAmC;IACnC,SAAS,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,SAAS,QAAQ,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,SAAiB,EAAE,IAAkB;QAChD,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,SAAS,YAAY,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;CACF;AAED,eAAe,WAAW,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@groupwisdom/sdk",
+  "version": "0.1.0",
+  "description": "Official JavaScript/TypeScript SDK for the GroupWisdom API",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && node build-cjs.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "groupwisdom",
+    "sdk",
+    "api",
+    "knowledge",
+    "insights"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  }
+}