yes-as-a-service-api-client 1.0.0

package/README.md

@@ -0,0 +1,57 @@
+![yes-hero-banner-illustration](https://github.com/user-attachments/assets/9623e970-e9ba-4847-bb28-8bfc8fb2dea2)
+# Yes As A Service API Client
+A tiny JavaScript/TypeScript client for the Yes As A Service API — fetch random positive affirmations with a single request.
+
+### 📦 Installation
+```console
+npm install yes-as-a-service-api-client
+```
+
+### 📜 Design Philosophy
+1. Zero configuration
+2. No inputs required
+3. Minimal surface area
+4. Predictable API responses
+5. Native fetch support
+6. TypeScript-first
+
+### 🔤 Example Usage
+```javascript
+import { getAYes } from "yes-as-a-service-api-client";
+
+async function run() {
+  const response = await getAYes();
+  if (response.code === "api-ok") {
+    console.log(response.payload?.affirmation);
+  } else {
+    console.error(response.message);
+  }
+}
+
+run();
+
+// Sample Success Response
+/*
+{
+  "code": "api-ok",
+  "message": "No errors encountered, check payload",
+  "payload": {
+    "affirmation": "Yes! Everything is working exactly as intended."
+  }
+}
+*/
+
+// Sample Error Response
+/*{
+  "code": "api-fail",
+  "message": "Something went wrong",
+  "payload": null
+}*/
+```
+
+### 📘  Contributing
+Contributions, suggestions, and improvements are welcome.<br/>
+Feel free to open issues or pull requests.
+
+### ❤️ Support
+Like this project? Support it with a github star, it would mean a lot to me! Cheers and Happy Coding.

package/dist/get-a-yes/index.d.ts

@@ -0,0 +1,5 @@
+import { TAPIResponse } from "../types/index.js";
+type TOutput = TAPIResponse;
+declare function getAYes(): Promise<TOutput>;
+export { getAYes };
+//# sourceMappingURL=index.d.ts.map

package/dist/get-a-yes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/get-a-yes/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,KAAK,OAAO,GAAG,YAAY,CAAC;AAG5B,iBAAe,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CA2BzC;AAGD,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/get-a-yes/index.js

@@ -0,0 +1,34 @@
+/* app imports */
+import { API_ROOT } from "../shared/index.js";
+/* module */
+async function getAYes() {
+    try {
+        /* setup */
+        const API_URL = `${API_ROOT}/yes`;
+        /* fetch */
+        const response = await fetch(API_URL);
+        /* check and return */
+        if (!response.ok) {
+            throw new Error("Get A Yes: Sorry, Something Went Wrong");
+        }
+        else {
+            const affirmation = await response.json();
+            return {
+                code: "api-ok",
+                message: "No errors encountered, check payload",
+                payload: { affirmation }
+            };
+        }
+    }
+    catch (error) {
+        console.error(error);
+        return {
+            code: "api-fail",
+            message: "Oops, something went wrong!",
+            payload: null,
+        };
+    }
+}
+/* exports */
+export { getAYes };
+//# sourceMappingURL=index.js.map

package/dist/get-a-yes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/get-a-yes/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAM9C,YAAY;AACZ,KAAK,UAAU,OAAO;IACpB,IAAK,CAAC;QACJ,WAAW;QACX,MAAM,OAAO,GAAG,GAAG,QAAQ,MAAM,CAAC;QAElC,WAAW;QACX,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtC,sBAAsB;QACtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC1C,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,sCAAsC;gBAC/C,OAAO,EAAE,EAAE,WAAW,EAAE;aACzB,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,6BAA6B;YACtC,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,aAAa;AACb,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./get-a-yes/index.js";
+export * from "./types/index.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":"AACA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+/* exports */
+export * from "./get-a-yes/index.js";
+export * from "./types/index.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,aAAa;AACb,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/shared/index.d.ts

@@ -0,0 +1,2 @@
+export declare const API_ROOT = "https://yes.lavx.hu";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,wBAAwB,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,2 @@
+export const API_ROOT = "https://yes.lavx.hu";
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,qBAAqB,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+export type TAPIResponse = {
+    code: "api-ok" | "api-fail";
+    message: string;
+    payload: null | {
+        affirmation: string;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,IAAI,GAAG;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "yes-as-a-service-api-client",
+  "description": "A minimal JavaScript/TypeScript client for the Yes As A Service API — an API that always responds with a positive affirmation.",
+  "type": "module",
+  "version": "1.0.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "yes-as-a-service",
+    "affirmation-api",
+    "public-api",
+    "tiny-api",
+    "npm-api-client",
+    "positivity",
+    "fun-api",
+    "fetch",
+    "typescript"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NPM-Workbench/yes-as-a-service-api-client"
+  },
+  "homepage": "https://github.com/NPM-Workbench/yes-as-a-service-api-client",
+  "bugs": {
+    "url": "https://github.com/NPM-Workbench/yes-as-a-service-api-client/issues"
+  }
+}