cognitive-decision-sdk 0.1.0

package/README.md

@@ -0,0 +1,46 @@
+# cognitive-decision
+
+Tiny SDK to call the `classify` method of the Cognitive Decision.
+
+Installation
+
+You can install from your repo or publish the package. For local testing, from the project root:
+
+```bash
+npm install ./sdk
+```
+
+Usage (CommonJS / Node)
+
+```js
+const { ClassifierClient } = require('cognitive-decision');
+
+// No URL required — defaults to the public deployment
+const client = new ClassifierClient();
+
+(async () => {
+  const resp = await client.classify('I love transformers!', ['positive','negative']);
+  console.log(resp);
+})();
+```
+
+Usage (TypeScript / ESM)
+
+```ts
+import { ClassifierClient } from 'cognitive-decision';
+
+// No options required — defaults to https://cognitive-decision.vercel.app
+const client = new ClassifierClient();
+const resp = await client.classify('I love transformers!', ['positive','negative']);
+console.log(resp);
+```
+
+Notes
+
+- The SDK uses the global `fetch` API. In Node.js versions older than 18, install `node-fetch` in your project:
+
+```bash
+npm install node-fetch
+```
+
+- The SDK defaults the API base URL to https://cognitive-decision.vercel.app.

package/index.d.ts

@@ -0,0 +1,12 @@
+export interface ClassifyResponse {
+  res: any;
+}
+
+export interface ClassifierOptions {
+  baseUrl?: string;
+}
+
+export class ClassifierClient {
+  constructor();
+  classify(text: string, labels: string[]): Promise<ClassifyResponse>;
+}

package/index.js

@@ -0,0 +1,59 @@
+/*
+  cognitive-decision
+  Simple SDK to call the /classify endpoint of your app.
+
+  Node compatibility: uses global fetch (Node 18+). For earlier Node versions,
+  install `node-fetch` and the SDK will require it automatically.
+*/
+
+let fetchFn = (typeof globalThis !== 'undefined' && globalThis.fetch) ? globalThis.fetch : null;
+try {
+  if (!fetchFn) fetchFn = require('node-fetch');
+} catch (e) {
+  // ignore; we'll throw below if no fetch available
+}
+
+if (!fetchFn) {
+  throw new Error('Fetch API not found. Use Node 18+ or install node-fetch');
+}
+
+class ClassifierClient {
+  /**
+   * The SDK always uses the public deployment URL; any provided options are ignored.
+   * @param {any} [options] ignored
+   */
+  constructor(options) {
+    if (options) {
+      try {
+        // Friendly warning when consumers pass options
+        console.warn('ClassifierClient: provided options/baseUrl are ignored; using https://cognitive-decision.vercel.app/api');
+      } catch (e) {}
+    }
+    this.baseUrl = 'https://cognitive-decision.vercel.app/api';
+  }
+
+  /**
+   * Call the classification API.
+   * @param {string} text
+   * @param {string[]} labels
+   */
+  async classify(text, labels) {
+    if (!text) throw new Error('text is required');
+    if (!labels || !Array.isArray(labels)) throw new Error('labels array is required');
+
+    const res = await fetchFn(this.baseUrl + '/classify', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ text, labels })
+    });
+
+    if (!res.ok) {
+      const body = await res.text().catch(() => '');
+      throw new Error(`Classifier request failed: ${res.status} ${res.statusText} ${body}`);
+    }
+
+    return res.json();
+  }
+}
+
+module.exports = { ClassifierClient };

package/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "cognitive-decision-sdk",
+  "version": "0.1.0",
+  "description": "Tiny SDK to call the Cognitive Decision classification API",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "keywords": ["huggingface", "classification", "sdk"],
+  "license": "MIT"
+}