@repoxcode/docker-registry 1.0.0

package/README.md

@@ -0,0 +1,138 @@
+# DockeRegistrySDK
+
+Connect to your own Docker Registry
+
+---
+
+This package is a tool to connect with the [container registry distribution](https://hub.docker.com/_/registry).
+
+## Get Started
+
+If your container registry is public, you can use this library directly. If your container registry is authentication protected, the first thing to check is to make sure your Docker Engine has successfully logged into your container registry. If you have not logged in, you can do so by using the following command:
+
+``` powershell
+$ docker login <registry_hostname>  
+```
+
+For more information, you can visit the page about [docker login](https://docs.docker.com/reference/cli/docker/login/).
+
+### Ping
+
+Checking connectivity with docker container registry.
+
+`registry.ping()`
+
+**Example**
+
+``` ts
+import Registry from "@repoxcode/docker-registry";
+
+const registry = Registry({ hostname: "localhost", port: 5001 });
+
+const isConnected = await registry.ping();
+```
+
+### Catalog
+
+Get a list of catalogs in the container registry.
+
+`registry.catalog({ n, last })`
+
+- **optional** n: the amount of data you want to retrieve.
+- **optional** last: the beginning of the data sequence you want to retrieve
+
+**Example**
+
+``` ts
+import Registry from "@repoxcode/docker-registry";
+
+const registry = Registry({ hostname: "localhost", port: 5001 });
+
+const catalog = await registry.catalog();
+```
+
+### Tag
+
+Get a list of tags on a container, inside the container registry.
+
+`registry.tag(name, { n, last })`
+
+- name: container name.
+- **optional** n: the amount of data you want to retrieve.
+- **optional** last: the beginning of the data sequence you want to retrieve
+
+**Example**
+
+``` ts
+import Registry from "@repoxcode/docker-registry";
+
+const registry = Registry({ hostname: "localhost", port: 5001 });
+
+const catalog = await registry.tag();
+```
+
+### Manifest
+
+Retrieving details from the data catalog inside the docker container registry.
+
+`registry.manifest(name, reference)`
+
+- name: container name.
+- reference: container reference, you can use container tag.
+
+**Example**
+
+``` ts
+import Registry from "@repoxcode/docker-registry";
+
+const registry = Registry({ hostname: "localhost", port: 5001 });
+
+const catalog = await registry.manifest("nginx", "latest");
+```
+
+### Update Manifest
+
+Retrieving details from the data catalog inside the docker container registry.
+
+`registry.manifest(name, reference, body)`
+
+- name: container name.
+- reference: container reference, you can use container tag.
+- body: the data you want to update.
+
+**Example**
+
+``` ts
+import Registry from "@repoxcode/docker-registry";
+
+const registry = Registry({ hostname: "localhost", port: 5001 });
+
+const body = {
+  name: "nginx-test",
+}
+
+const catalog = await registry.manifestUpdate("nginx", "latest", body);
+```
+
+### Delete Manifest
+
+Remove catalog from docker container registry.
+
+`registry.manifest(name, reference)`
+
+- name: container name.
+- reference: container reference, you can use container tag.
+
+**Example**
+
+``` ts
+import Registry from "@repoxcode/docker-registry";
+
+const registry = Registry({ hostname: "localhost", port: 5001 });
+
+const body = {
+  name: "nginx-test",
+}
+
+const catalog = await registry.manifestDelete("nginx", "latest");
+```

package/dist/index.d.mts

@@ -0,0 +1,43 @@
+interface RegistryCatalog {
+    repositories: string[];
+}
+interface RegistryTagResponse {
+    name: string;
+    tags: string[];
+}
+interface RegistryManifest {
+    name: string;
+    tag: string;
+    fsLayers: {
+        [key: string]: string;
+    }[];
+    history: string;
+    signature: string;
+}
+
+declare class Registry {
+    constructor({ hostname, port }: RegistryConstructor);
+    private readonly version;
+    private readonly hostname;
+    private readonly port;
+    private createRequestOption;
+    ping(): Promise<void>;
+    tag(repository: string, query?: {
+        n: number;
+        last: number;
+    }): Promise<RegistryTagResponse>;
+    manifest(repository: string, reference: string): Promise<RegistryManifest>;
+    manifestUpdate(repository: string, reference: string, body: RegistryManifest): Promise<void>;
+    manifestDelete(repository: string, tag: string): Promise<any>;
+    catalog(query?: {
+        n: number;
+        last: number;
+    }): Promise<RegistryCatalog>;
+}
+
+type RegistryConstructor = {
+    hostname?: string;
+    port?: number;
+};
+
+export { Registry as default };

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+interface RegistryCatalog {
+    repositories: string[];
+}
+interface RegistryTagResponse {
+    name: string;
+    tags: string[];
+}
+interface RegistryManifest {
+    name: string;
+    tag: string;
+    fsLayers: {
+        [key: string]: string;
+    }[];
+    history: string;
+    signature: string;
+}
+
+declare class Registry {
+    constructor({ hostname, port }: RegistryConstructor);
+    private readonly version;
+    private readonly hostname;
+    private readonly port;
+    private createRequestOption;
+    ping(): Promise<void>;
+    tag(repository: string, query?: {
+        n: number;
+        last: number;
+    }): Promise<RegistryTagResponse>;
+    manifest(repository: string, reference: string): Promise<RegistryManifest>;
+    manifestUpdate(repository: string, reference: string, body: RegistryManifest): Promise<void>;
+    manifestDelete(repository: string, tag: string): Promise<any>;
+    catalog(query?: {
+        n: number;
+        last: number;
+    }): Promise<RegistryCatalog>;
+}
+
+type RegistryConstructor = {
+    hostname?: string;
+    port?: number;
+};
+
+export { Registry as default };

package/dist/index.js

@@ -0,0 +1,211 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/utils.ts
+var import_http = require("http");
+var Utils = class {
+  static connect(options) {
+    return __async(this, null, function* () {
+      try {
+        const res = yield this.req(options);
+        return res;
+      } catch (error) {
+        throw error.message;
+      }
+    });
+  }
+  static req(options) {
+    return new Promise((resolve, reject) => {
+      let headers = {
+        "content-type": "application/json"
+      };
+      if (options.headers) {
+        headers = __spreadValues(__spreadValues({}, headers), options.headers);
+      }
+      if (options.body) {
+        options.body = JSON.stringify(options.body);
+        headers["content-length"] = Buffer.byteLength(options.body);
+      }
+      if (options.query) {
+        const urlParams = this.urlQuery(options.query);
+        options.path = `${options.path}?${urlParams}`;
+      }
+      const config = {
+        method: options.method,
+        hostname: options.hostname,
+        port: options.port,
+        path: options.path,
+        headers,
+        timeout: 6e4
+      };
+      const clientRequest = (0, import_http.request)(config, (res) => {
+        if (!res.statusCode || res.statusCode < 200 || res.statusCode >= 400) {
+          return reject(new Error("Bad response status: " + res.statusCode));
+        }
+        let body = "";
+        res.setEncoding("utf8");
+        res.on("data", (chunk) => body += chunk);
+        res.on("end", () => {
+          let responseBody;
+          try {
+            responseBody = body ? JSON.parse(body) : void 0;
+          } catch (error) {
+            return reject(error);
+          }
+          resolve(responseBody);
+        });
+      });
+      clientRequest.write(options.body);
+      clientRequest.on("error", (e) => {
+        reject(e);
+      });
+      clientRequest.end();
+    });
+  }
+  static urlQuery(params) {
+    return Object.entries(params != null ? params : {}).map(([key, value]) => `${key}=${JSON.stringify(value)}`).join("&");
+  }
+};
+
+// src/index.ts
+var Registry = class {
+  constructor({ hostname, port }) {
+    this.version = "v2";
+    this.hostname = hostname != null ? hostname : "localhost";
+    this.port = port != null ? port : 5001;
+    if (process.env.REGISTRY_HOSTNAME) {
+      this.hostname = process.env.REGISTRY_HOSTNAME;
+    }
+    if (process.env.REGISTRY_PORT) {
+      this.port = Number(process.env.REGISTRY_PORT);
+    }
+  }
+  createRequestOption(param) {
+    var _a, _b, _c;
+    return {
+      method: param.method,
+      hostname: this.hostname,
+      port: this.port,
+      path: `/${this.version}/${param.path}`,
+      headers: (_a = param.headers) != null ? _a : {},
+      query: (_b = param.query) != null ? _b : {},
+      body: (_c = param.body) != null ? _c : {}
+    };
+  }
+  ping() {
+    return __async(this, null, function* () {
+      const options = this.createRequestOption({
+        method: "GET",
+        path: ""
+      });
+      return yield Utils.connect(options);
+    });
+  }
+  tag(repository, query) {
+    return __async(this, null, function* () {
+      const options = this.createRequestOption({
+        method: "GET",
+        path: `${repository}/tags/list`,
+        query
+      });
+      return yield Utils.connect(options);
+    });
+  }
+  manifest(repository, reference) {
+    return __async(this, null, function* () {
+      const options = this.createRequestOption({
+        method: "GET",
+        path: `${repository}/manifest/${reference}`
+      });
+      return yield Utils.connect(options);
+    });
+  }
+  manifestUpdate(repository, reference, body) {
+    return __async(this, null, function* () {
+      const options = this.createRequestOption({
+        method: "PUT",
+        path: `${repository}/manifest/${reference}`,
+        body
+      });
+      return yield Utils.connect(options);
+    });
+  }
+  manifestDelete(repository, tag) {
+    return __async(this, null, function* () {
+      const options = this.createRequestOption({
+        method: "DELETE",
+        path: `${repository}/manifests/${tag}`
+      });
+      return yield Utils.connect(options);
+    });
+  }
+  catalog(query) {
+    return __async(this, null, function* () {
+      const options = this.createRequestOption({
+        method: "GET",
+        path: "_catalog",
+        query
+      });
+      return yield Utils.connect(options);
+    });
+  }
+};
+var index_default = Registry;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/utils.ts"],"sourcesContent":["import { RegistryCatalog, RegistryManifest, RegistryTagResponse } from './interfaces';\r\nimport { ConnectOptions, Utils } from './utils';\r\n\r\nclass Registry {\r\n\r\n  constructor({ hostname, port }: RegistryConstructor) {\r\n\r\n    this.hostname = hostname ?? 'localhost';\r\n    this.port = port ?? 5001;\r\n\r\n    // Get the hostname from the environment\r\n    if (process.env.REGISTRY_HOSTNAME) {\r\n\r\n      this.hostname = process.env.REGISTRY_HOSTNAME;\r\n\r\n    }\r\n\r\n    // Get the port from the environment\r\n    if (process.env.REGISTRY_PORT) {\r\n\r\n      this.port = Number(process.env.REGISTRY_PORT);\r\n\r\n    }\r\n\r\n  }\r\n\r\n  private readonly version  : string = 'v2';\r\n  private readonly hostname : string;\r\n  private readonly port     : number;\r\n\r\n  private createRequestOption(param: CreateRequestOption): ConnectOptions {\r\n\r\n    return {\r\n      method   : param.method,\r\n      hostname : this.hostname,\r\n      port     : this.port,\r\n      path     : `/${ this.version }/${ param.path }`,\r\n      headers  : param.headers ?? {},\r\n      query    : param.query ?? {},\r\n      body     : param.body ?? {}\r\n    };\r\n\r\n  }\r\n\r\n  public async ping(): Promise<void> {\r\n\r\n    const options: ConnectOptions = this.createRequestOption({\r\n      method : 'GET',\r\n      path   : ''\r\n    });\r\n\r\n    return await Utils.connect(options);\r\n\r\n  }\r\n\r\n  public async tag(repository: string, query?: { n : number; last : number }): Promise<RegistryTagResponse> {\r\n\r\n    const options: ConnectOptions = this.createRequestOption({\r\n      method : 'GET',\r\n      path   : `${ repository }/tags/list`,\r\n      query  : query\r\n    });\r\n\r\n    return await Utils.connect(options);\r\n\r\n  }\r\n\r\n  public async manifest(repository: string, reference: string): Promise<RegistryManifest> {\r\n\r\n    const options: ConnectOptions = this.createRequestOption({\r\n      method : 'GET',\r\n      path   : `${ repository }/manifest/${ reference }`\r\n    });\r\n\r\n    return await Utils.connect(options);\r\n\r\n  }\r\n\r\n  public async manifestUpdate(repository: string, reference: string, body: RegistryManifest): Promise<void> {\r\n\r\n    const options: ConnectOptions = this.createRequestOption({\r\n      method : 'PUT',\r\n      path   : `${ repository }/manifest/${ reference }`,\r\n      body   : body\r\n    });\r\n\r\n    return await Utils.connect(options);\r\n\r\n  }\r\n\r\n  public async manifestDelete(repository: string, tag: string): Promise<any> {\r\n\r\n    const options: ConnectOptions = this.createRequestOption({\r\n      method : 'DELETE',\r\n      path   : `${ repository }/manifests/${ tag }`\r\n    });\r\n\r\n    return await Utils.connect(options);\r\n\r\n  }\r\n\r\n  public async catalog(query?: { n : number; last : number }): Promise<RegistryCatalog> {\r\n\r\n    const options: ConnectOptions = this.createRequestOption({\r\n      method : 'GET',\r\n      path   : '_catalog',\r\n      query  : query\r\n    });\r\n\r\n    return await Utils.connect(options);\r\n\r\n  }\r\n\r\n}\r\n\r\nexport default Registry;\r\n\r\ntype RegistryConstructor = {\r\n  hostname? : string;\r\n  port?     : number;\r\n};\r\n\r\ntype CreateRequestOption = {\r\n  method   : 'GET' | 'PUT' | 'POST' | 'DELETE' | 'HEAD';\r\n  path     : string;\r\n  headers? : any;\r\n  query?   : any;\r\n  body?    : any;\r\n};\r\n","import { ClientRequest, OutgoingHttpHeaders, request } from 'http';\r\nimport { RequestOptions } from 'https';\r\n\r\nexport class Utils {\r\n\r\n  static async connect(options: ConnectOptions): Promise<any> {\r\n\r\n    try {\r\n\r\n      const res = await this.req(options);\r\n\r\n      return res;\r\n\r\n    } catch(error: any) {\r\n\r\n      throw error.message;\r\n\r\n    }\r\n\r\n  }\r\n\r\n  private static req(options: ConnectOptions): Promise<any> {\r\n\r\n    return new Promise((resolve, reject) => {\r\n\r\n      let headers: OutgoingHttpHeaders = {\r\n        'content-type' : 'application/json'\r\n      };\r\n\r\n      if (options.headers) {\r\n\r\n        headers = { ...headers, ...options.headers };\r\n\r\n      }\r\n\r\n      if (options.body) {\r\n\r\n        options.body = JSON.stringify(options.body);\r\n        headers['content-length'] = Buffer.byteLength(options.body);\r\n\r\n      }\r\n\r\n      if (options.query) {\r\n\r\n        const urlParams = this.urlQuery(options.query);\r\n        options.path = `${ options.path }?${ urlParams }`;\r\n\r\n      }\r\n\r\n      const config: RequestOptions = {\r\n        method   : options.method,\r\n        hostname : options.hostname,\r\n        port     : options.port,\r\n        path     : options.path,\r\n        headers  : headers,\r\n        timeout  : 60000\r\n      };\r\n\r\n      const clientRequest: ClientRequest = request(config, (res) => {\r\n\r\n        // reject on bad status\r\n        if (!res.statusCode || res.statusCode < 200 || res.statusCode >= 400) {\r\n\r\n          return reject(new Error('Bad response status: ' + res.statusCode));\r\n\r\n        }\r\n\r\n        // cumulate data\r\n        let body: string = '';\r\n\r\n        res.setEncoding('utf8');\r\n\r\n        res.on('data', (chunk) => body += chunk);\r\n\r\n        res.on('end', () => {\r\n\r\n          let responseBody;\r\n\r\n          try {\r\n\r\n            responseBody = body ? JSON.parse(body) : undefined;\r\n\r\n          } catch(error) {\r\n\r\n            return reject(error);\r\n\r\n          }\r\n\r\n          resolve(responseBody);\r\n\r\n        });\r\n\r\n      });\r\n\r\n      // Send the POST data\r\n      clientRequest.write(options.body);\r\n\r\n      clientRequest.on('error', (e) => {\r\n\r\n        reject(e);\r\n\r\n      });\r\n\r\n      clientRequest.end();\r\n\r\n    });\r\n\r\n  }\r\n\r\n  static urlQuery(params: any): string {\r\n\r\n    return Object.entries(params ?? {}).map(([ key, value ]) => `${ key }=${ JSON.stringify(value) }`).join('&');\r\n\r\n  }\r\n\r\n}\r\n\r\nexport type ConnectOptions = {\r\n  method   : string;\r\n  hostname : string;\r\n  port     : number;\r\n  path     : string;\r\n  headers? : any;\r\n  query?   : any;\r\n  body?    : any;\r\n};\r\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,191 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// src/utils.ts
+import { request } from "http";
+var Utils = class {
+  static connect(options) {
+    return __async(this, null, function* () {
+      try {
+        const res = yield this.req(options);
+        return res;
+      } catch (error) {
+        throw error.message;
+      }
+    });
+  }
+  static req(options) {
+    return new Promise((resolve, reject) => {
+      let headers = {
+        "content-type": "application/json"
+      };
+      if (options.headers) {
+        headers = __spreadValues(__spreadValues({}, headers), options.headers);
+      }
+      if (options.body) {
+        options.body = JSON.stringify(options.body);
+        headers["content-length"] = Buffer.byteLength(options.body);
+      }
+      if (options.query) {
+        const urlParams = this.urlQuery(options.query);
+        options.path = `${options.path}?${urlParams}`;
+      }
+      const config = {
+        method: options.method,
+        hostname: options.hostname,
+        port: options.port,
+        path: options.path,
+        headers,
+        timeout: 6e4
+      };
+      const clientRequest = request(config, (res) => {
+        if (!res.statusCode || res.statusCode < 200 || res.statusCode >= 400) {
+          return reject(new Error("Bad response status: " + res.statusCode));
+        }
+        let body = "";
+        res.setEncoding("utf8");
+        res.on("data", (chunk) => body += chunk);
+        res.on("end", () => {
+          let responseBody;
+          try {
+            responseBody = body ? JSON.parse(body) : void 0;
+          } catch (error) {
+            return reject(error);
+          }
+          resolve(responseBody);
+        });
+      });
+      clientRequest.write(options.body);
+      clientRequest.on("error", (e) => {
+        reject(e);
+      });
+      clientRequest.end();
+    });
+  }
+  static urlQuery(params) {
+    return Object.entries(params != null ? params : {}).map(([key, value]) => `${key}=${JSON.stringify(value)}`).join("&");
+  }
+};
+
+// src/index.ts
+var Registry = class {
+  constructor({ hostname, port }) {
+    this.version = "v2";
+    this.hostname = hostname != null ? hostname : "localhost";
+    this.port = port != null ? port : 5001;
+    if (process.env.REGISTRY_HOSTNAME) {
+      this.hostname = process.env.REGISTRY_HOSTNAME;
+    }
+    if (process.env.REGISTRY_PORT) {
+      this.port = Number(process.env.REGISTRY_PORT);
+    }
+  }
+  createRequestOption(param) {
+    var _a, _b, _c;
+    return {
+      method: param.method,
+      hostname: this.hostname,
+      port: this.port,
+      path: `/${this.version}/${param.path}`,
+      headers: (_a = param.headers) != null ? _a : {},
+      query: (_b = param.query) != null ? _b : {},
+      body: (_c = param.body) != null ? _c : {}
+    };
+  }
+  ping() {
+    return __async(this, null, function* () {
+      const options = this.createRequestOption({
+        method: "GET",
+        path: ""
+      });
+      return yield Utils.connect(options);
+    });
+  }
+  tag(repository, query) {
+    return __async(this, null, function* () {
+      const options = this.createRequestOption({
+        method: "GET",
+        path: `${repository}/tags/list`,
+        query
+      });
+      return yield Utils.connect(options);
+    });
+  }
+  manifest(repository, reference) {
+    return __async(this, null, function* () {
+      const options = this.createRequestOption({
+        method: "GET",
+        path: `${repository}/manifest/${reference}`
+      });
+      return yield Utils.connect(options);
+    });
+  }
+  manifestUpdate(repository, reference, body) {
+    return __async(this, null, function* () {
+      const options = this.createRequestOption({
+        method: "PUT",
+        path: `${repository}/manifest/${reference}`,
+        body
+      });
+      return yield Utils.connect(options);
+    });
+  }
+  manifestDelete(repository, tag) {
+    return __async(this, null, function* () {
+      const options = this.createRequestOption({
+        method: "DELETE",
+        path: `${repository}/manifests/${tag}`
+      });
+      return yield Utils.connect(options);
+    });
+  }
+  catalog(query) {
+    return __async(this, null, function* () {
+      const options = this.createRequestOption({
+        method: "GET",
+        path: "_catalog",
+        query
+      });
+      return yield Utils.connect(options);
+    });
+  }
+};
+var index_default = Registry;
+export {
+  index_default as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts","../src/index.ts"],"sourcesContent":["import { ClientRequest, OutgoingHttpHeaders, request } from 'http';\r\nimport { RequestOptions } from 'https';\r\n\r\nexport class Utils {\r\n\r\n  static async connect(options: ConnectOptions): Promise<any> {\r\n\r\n    try {\r\n\r\n      const res = await this.req(options);\r\n\r\n      return res;\r\n\r\n    } catch(error: any) {\r\n\r\n      throw error.message;\r\n\r\n    }\r\n\r\n  }\r\n\r\n  private static req(options: ConnectOptions): Promise<any> {\r\n\r\n    return new Promise((resolve, reject) => {\r\n\r\n      let headers: OutgoingHttpHeaders = {\r\n        'content-type' : 'application/json'\r\n      };\r\n\r\n      if (options.headers) {\r\n\r\n        headers = { ...headers, ...options.headers };\r\n\r\n      }\r\n\r\n      if (options.body) {\r\n\r\n        options.body = JSON.stringify(options.body);\r\n        headers['content-length'] = Buffer.byteLength(options.body);\r\n\r\n      }\r\n\r\n      if (options.query) {\r\n\r\n        const urlParams = this.urlQuery(options.query);\r\n        options.path = `${ options.path }?${ urlParams }`;\r\n\r\n      }\r\n\r\n      const config: RequestOptions = {\r\n        method   : options.method,\r\n        hostname : options.hostname,\r\n        port     : options.port,\r\n        path     : options.path,\r\n        headers  : headers,\r\n        timeout  : 60000\r\n      };\r\n\r\n      const clientRequest: ClientRequest = request(config, (res) => {\r\n\r\n        // reject on bad status\r\n        if (!res.statusCode || res.statusCode < 200 || res.statusCode >= 400) {\r\n\r\n          return reject(new Error('Bad response status: ' + res.statusCode));\r\n\r\n        }\r\n\r\n        // cumulate data\r\n        let body: string = '';\r\n\r\n        res.setEncoding('utf8');\r\n\r\n        res.on('data', (chunk) => body += chunk);\r\n\r\n        res.on('end', () => {\r\n\r\n          let responseBody;\r\n\r\n          try {\r\n\r\n            responseBody = body ? JSON.parse(body) : undefined;\r\n\r\n          } catch(error) {\r\n\r\n            return reject(error);\r\n\r\n          }\r\n\r\n          resolve(responseBody);\r\n\r\n        });\r\n\r\n      });\r\n\r\n      // Send the POST data\r\n      clientRequest.write(options.body);\r\n\r\n      clientRequest.on('error', (e) => {\r\n\r\n        reject(e);\r\n\r\n      });\r\n\r\n      clientRequest.end();\r\n\r\n    });\r\n\r\n  }\r\n\r\n  static urlQuery(params: any): string {\r\n\r\n    return Object.entries(params ?? {}).map(([ key, value ]) => `${ key }=${ JSON.stringify(value) }`).join('&');\r\n\r\n  }\r\n\r\n}\r\n\r\nexport type ConnectOptions = {\r\n  method   : string;\r\n  hostname : string;\r\n  port     : number;\r\n  path     : string;\r\n  headers? : any;\r\n  query?   : any;\r\n  body?    : any;\r\n};\r\n","import { RegistryCatalog, RegistryManifest, RegistryTagResponse } from './interfaces';\r\nimport { ConnectOptions, Utils } from './utils';\r\n\r\nclass Registry {\r\n\r\n  constructor({ hostname, port }: RegistryConstructor) {\r\n\r\n    this.hostname = hostname ?? 'localhost';\r\n    this.port = port ?? 5001;\r\n\r\n    // Get the hostname from the environment\r\n    if (process.env.REGISTRY_HOSTNAME) {\r\n\r\n      this.hostname = process.env.REGISTRY_HOSTNAME;\r\n\r\n    }\r\n\r\n    // Get the port from the environment\r\n    if (process.env.REGISTRY_PORT) {\r\n\r\n      this.port = Number(process.env.REGISTRY_PORT);\r\n\r\n    }\r\n\r\n  }\r\n\r\n  private readonly version  : string = 'v2';\r\n  private readonly hostname : string;\r\n  private readonly port     : number;\r\n\r\n  private createRequestOption(param: CreateRequestOption): ConnectOptions {\r\n\r\n    return {\r\n      method   : param.method,\r\n      hostname : this.hostname,\r\n      port     : this.port,\r\n      path     : `/${ this.version }/${ param.path }`,\r\n      headers  : param.headers ?? {},\r\n      query    : param.query ?? {},\r\n      body     : param.body ?? {}\r\n    };\r\n\r\n  }\r\n\r\n  public async ping(): Promise<void> {\r\n\r\n    const options: ConnectOptions = this.createRequestOption({\r\n      method : 'GET',\r\n      path   : ''\r\n    });\r\n\r\n    return await Utils.connect(options);\r\n\r\n  }\r\n\r\n  public async tag(repository: string, query?: { n : number; last : number }): Promise<RegistryTagResponse> {\r\n\r\n    const options: ConnectOptions = this.createRequestOption({\r\n      method : 'GET',\r\n      path   : `${ repository }/tags/list`,\r\n      query  : query\r\n    });\r\n\r\n    return await Utils.connect(options);\r\n\r\n  }\r\n\r\n  public async manifest(repository: string, reference: string): Promise<RegistryManifest> {\r\n\r\n    const options: ConnectOptions = this.createRequestOption({\r\n      method : 'GET',\r\n      path   : `${ repository }/manifest/${ reference }`\r\n    });\r\n\r\n    return await Utils.connect(options);\r\n\r\n  }\r\n\r\n  public async manifestUpdate(repository: string, reference: string, body: RegistryManifest): Promise<void> {\r\n\r\n    const options: ConnectOptions = this.createRequestOption({\r\n      method : 'PUT',\r\n      path   : `${ repository }/manifest/${ reference }`,\r\n      body   : body\r\n    });\r\n\r\n    return await Utils.connect(options);\r\n\r\n  }\r\n\r\n  public async manifestDelete(repository: string, tag: string): Promise<any> {\r\n\r\n    const options: ConnectOptions = this.createRequestOption({\r\n      method : 'DELETE',\r\n      path   : `${ repository }/manifests/${ tag }`\r\n    });\r\n\r\n    return await Utils.connect(options);\r\n\r\n  }\r\n\r\n  public async catalog(query?: { n : number; last : number }): Promise<RegistryCatalog> {\r\n\r\n    const options: ConnectOptions = this.createRequestOption({\r\n      method : 'GET',\r\n      path   : '_catalog',\r\n      query  : query\r\n    });\r\n\r\n    return await Utils.connect(options);\r\n\r\n  }\r\n\r\n}\r\n\r\nexport default Registry;\r\n\r\ntype RegistryConstructor = {\r\n  hostname? : string;\r\n  port?     : number;\r\n};\r\n\r\ntype CreateRequestOption = {\r\n  method   : 'GET' | 'PUT' | 'POST' | 'DELETE' | 'HEAD';\r\n  path     : string;\r\n  headers? : any;\r\n  query?   : any;\r\n  body?    : any;\r\n};\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@repoxcode/docker-registry",
+  "version": "1.0.0",
+  "description": "SDK to connect to your own docker registry",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/repoxcodehub/node-docker-registry.git"
+  },
+  "keywords": [
+    "SDK",
+    "connect",
+    "docker",
+    "registry"
+  ],
+  "author": "catur",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/repoxcodehub/node-docker-registry/issues"
+  },
+  "homepage": "https://github.com/repoxcodehub/node-docker-registry#readme",
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@stylistic/eslint-plugin": "^5.6.1",
+    "@types/jest": "^30.0.0",
+    "eslint": "^9.39.2",
+    "globals": "^16.5.0",
+    "jest": "^30.2.0",
+    "jiti": "^2.6.1",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.50.0"
+  }
+}