gocreative-dockerhub-image 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Colin Hughes / GoCreative AI
+
+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

@@ -0,0 +1,45 @@
+# gocreative-dockerhub-image
+
+Tiny Node helper to look up Docker Hub image metadata (pulls, stars, tags) by owner/image via the GoCreative AI pay-per-call API. Bring your own gck_ API key or use the free demo tier (5/day per IP). For full multi-endpoint coverage install the unified `gocreative` package.
+
+## Install
+
+```bash
+npm install gocreative-dockerhub-image
+```
+
+## 30-second quickstart
+
+```js
+const { lookup } = require("gocreative-dockerhub-image");
+
+(async () => {
+  // Free demo tier (no key needed, 5 calls/day per IP):
+  console.log(await lookup("library/nginx"));
+
+  // Or with a paid API key:
+  console.log(await lookup("library/nginx", { apiKey: "gck_your_key_here" }));
+})();
+```
+
+You can also set `GOCREATIVE_API_KEY=gck_...` in your environment.
+
+## What this returns
+
+A JSON object with Docker Hub image metadata fetched live from the GoCreative AI API.
+
+## Need more endpoints?
+
+This package wraps just **one** GoCreative endpoint. For the full SDK with
+enrich / lookup / scrape / search across 145+ endpoints, install:
+
+```bash
+npm install gocreative
+```
+
+Powered by **GoCreative AI** — free tier 5 calls/day, paid plans at
+<https://api.gocreativeai.com/credits/buy>.
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,31 @@
+// gocreative-dockerhub-image — narrow GoCreative AI helper. https://api.gocreativeai.com
+const BASE_URL = "https://api.gocreativeai.com";
+const USER_AGENT = "gocreative-dockerhub-image/0.1.0";
+
+class GoCreativeError extends Error {}
+
+async function lookup(ownerImage, opts = {}) {
+  const apiKey = opts.apiKey || process.env.GOCREATIVE_API_KEY || null;
+  const timeout = opts.timeout || 30000;
+  const headers = { "User-Agent": USER_AGENT, "Accept": "application/json" };
+  if (apiKey) headers["Authorization"] = `Bearer ${apiKey}`;
+  const encoded = String(ownerImage).split("/").map(encodeURIComponent).join("/");
+  const ctl = new AbortController();
+  const t = setTimeout(() => ctl.abort(), timeout);
+  const fetchOnce = (url) => fetch(url, { headers, signal: ctl.signal });
+  try {
+    let r = await fetchOnce(`${BASE_URL}/v1/lookup/dockerhub/${encoded}`);
+    if (r.status === 402 && !apiKey) {
+      r = await fetchOnce(`${BASE_URL}/demo/dockerhub/${encoded}`);
+    }
+    if (r.status >= 400) {
+      const text = await r.text().catch(() => "");
+      throw new GoCreativeError(`HTTP ${r.status}: ${text.slice(0, 300)}`);
+    }
+    const ct = r.headers.get("content-type") || "";
+    return ct.includes("application/json") ? r.json() : { raw: await r.text() };
+  } finally { clearTimeout(t); }
+}
+
+module.exports = { lookup, GoCreativeError };
+module.exports.default = lookup;

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "gocreative-dockerhub-image",
+  "version": "0.1.0",
+  "description": "Tiny Node helper to look up Docker Hub image metadata (pulls, stars, tags) by owner/image via the GoCreative AI pay-per-call API. Bring your own gck_ API key or use the free demo tier (5/day per IP). For full multi-endpoint coverage install the unified `gocreative` package.",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "docker",
+    "dockerhub",
+    "docker-hub",
+    "docker-image",
+    "container",
+    "gocreative",
+    "ai-agents"
+  ],
+  "author": "Colin Hughes <contact@gocreativeai.com>",
+  "license": "MIT",
+  "homepage": "https://api.gocreativeai.com",
+  "engines": {
+    "node": ">=18"
+  }
+}