@xgsd/artifact-sdk 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+type Ref = {
+    group: string;
+    key: string;
+    method: "get" | "put";
+    contentType?: string;
+};
+declare class ArtifactStorage {
+    private readonly url;
+    private readonly accessToken?;
+    constructor(url: string, accessToken?: string | undefined);
+    protected getSignedUrl(ref: Ref): Promise<{
+        url: string;
+        method: string;
+    }>;
+    uploadJson(path: string, obj: Record<string, unknown>): Promise<{
+        ok: true;
+    }>;
+    uploadFile(localPath: string, remotePath: string, contentType?: string): Promise<{
+        ok: true;
+    }>;
+    downloadJson<T = Record<string, unknown>>(path: string): Promise<T>;
+    downloadFile(remotePath: string, localPath: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    delete(path: string): Promise<{
+        ok: true;
+    }>;
+    list(prefix: string): Promise<string[]>;
+}
+
+export { ArtifactStorage };

package/dist/index.js

@@ -0,0 +1,216 @@
+// src/index.ts
+import { createReadStream, createWriteStream } from "fs";
+import { pipeline } from "stream/promises";
+function parse(q) {
+  const idx = q.indexOf(":");
+  if (idx === -1) {
+    return null;
+  }
+  const group = q.slice(0, idx);
+  const key = q.slice(idx + 1);
+  if (!group || !key) {
+    return null;
+  }
+  return {
+    group,
+    key
+  };
+}
+var ArtifactStorage = class {
+  constructor(url, accessToken) {
+    this.url = url;
+    this.accessToken = accessToken;
+  }
+  url;
+  accessToken;
+  async getSignedUrl(ref) {
+    const url = `${this.url}/sign`;
+    const res = await fetch(url, {
+      method: "POST",
+      body: JSON.stringify(ref),
+      headers: {
+        authorization: `Bearer ${this.accessToken}`,
+        "content-type": "application/json",
+        accept: "application/json"
+      }
+    });
+    if (res.status >= 400) {
+      throw new Error(`http-${res.status}`);
+    }
+    const json = await res.json();
+    return {
+      url: json.url,
+      method: json.method
+    };
+  }
+  // -----------------------
+  // JSON UPLOAD
+  // -----------------------
+  async uploadJson(path, obj) {
+    const ref = parse(path);
+    if (!ref) {
+      throw new Error("invalid remote path");
+    }
+    const { url, method } = await this.getSignedUrl({
+      ...ref,
+      method: "put",
+      contentType: "application/json"
+    });
+    const res = await fetch(url, {
+      method,
+      body: JSON.stringify(obj),
+      headers: {
+        "content-type": "application/json"
+      }
+    });
+    if (res.status >= 400) {
+      throw new Error(`http-${res.status}`);
+    }
+    return { ok: true };
+  }
+  // -----------------------
+  // FILE UPLOAD
+  // -----------------------
+  async uploadFile(localPath, remotePath, contentType = "application/octet-stream") {
+    const ref = parse(remotePath);
+    if (!ref) {
+      throw new Error("invalid remote path");
+    }
+    const { url, method } = await this.getSignedUrl({
+      ...ref,
+      method: "put",
+      contentType
+    });
+    const stream = createReadStream(localPath);
+    const res = await fetch(url, {
+      method,
+      body: stream,
+      //duplex: 'half',
+      headers: {
+        "content-type": contentType
+      }
+    });
+    if (res.status >= 400) {
+      throw new Error(`http-${res.status}`);
+    }
+    return { ok: true };
+  }
+  // -----------------------
+  // JSON DOWNLOAD
+  // -----------------------
+  async downloadJson(path) {
+    const ref = parse(path);
+    if (!ref) {
+      throw new Error("invalid remote path");
+    }
+    const { url, method } = await this.getSignedUrl({
+      ...ref,
+      method: "get"
+    });
+    const res = await fetch(url, {
+      method
+    });
+    if (res.status >= 400) {
+      throw new Error(`http-${res.status}`);
+    }
+    return await res.json();
+  }
+  // -----------------------
+  // FILE DOWNLOAD
+  // -----------------------
+  async downloadFile(remotePath, localPath) {
+    const ref = parse(remotePath);
+    if (!ref) {
+      throw new Error("invalid remote path");
+    }
+    const { url, method } = await this.getSignedUrl({
+      ...ref,
+      method: "get"
+    });
+    const res = await fetch(url, {
+      method
+    });
+    if (res.status >= 400) {
+      throw new Error(`http-${res.status}`);
+    }
+    if (!res.body) {
+      throw new Error("missing response body");
+    }
+    const file = createWriteStream(localPath);
+    await pipeline(res.body, file);
+  }
+  // -----------------------
+  // EXISTS
+  // -----------------------
+  async exists(path) {
+    try {
+      const ref = parse(path);
+      if (!ref) {
+        throw new Error("invalid remote path");
+      }
+      const { url } = await this.getSignedUrl({
+        ...ref,
+        method: "get"
+      });
+      const res = await fetch(url, {
+        method: "HEAD"
+      });
+      return res.status < 400;
+    } catch {
+      return false;
+    }
+  }
+  // -----------------------
+  // DELETE
+  // -----------------------
+  async delete(path) {
+    const ref = parse(path);
+    if (!ref) {
+      throw new Error("invalid remote path");
+    }
+    const url = `${this.url}/delete`;
+    const res = await fetch(url, {
+      method: "POST",
+      body: JSON.stringify(ref),
+      headers: {
+        authorization: `Bearer ${this.accessToken}`,
+        "content-type": "application/json",
+        accept: "application/json"
+      }
+    });
+    if (res.status >= 400) {
+      throw new Error(`http-${res.status}`);
+    }
+    return { ok: true };
+  }
+  // -----------------------
+  // LIST
+  // -----------------------
+  async list(prefix) {
+    const ref = parse(prefix);
+    if (!ref) {
+      throw new Error("invalid remote path");
+    }
+    const url = `${this.url}/list`;
+    const res = await fetch(url, {
+      method: "POST",
+      body: JSON.stringify({
+        group: ref.group,
+        prefix: ref.key
+      }),
+      headers: {
+        authorization: `Bearer ${this.accessToken}`,
+        "content-type": "application/json",
+        accept: "application/json"
+      }
+    });
+    if (res.status >= 400) {
+      throw new Error(`http-${res.status}`);
+    }
+    return await res.json();
+  }
+};
+export {
+  ArtifactStorage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { createReadStream, createWriteStream } from \"node:fs\";\nimport { pipeline } from \"node:stream/promises\";\n\ntype Ref = {\n  group: string;\n  key: string;\n  method: \"get\" | \"put\";\n  contentType?: string;\n};\n\nfunction parse(q: string): {\n  group: string;\n  key: string;\n} | null {\n  const idx = q.indexOf(\":\");\n\n  if (idx === -1) {\n    return null;\n  }\n\n  const group = q.slice(0, idx);\n  const key = q.slice(idx + 1);\n\n  if (!group || !key) {\n    return null;\n  }\n\n  return {\n    group,\n    key,\n  };\n}\n\nexport class ArtifactStorage {\n  constructor(\n    private readonly url: string,\n    private readonly accessToken?: string,\n  ) {}\n\n  protected async getSignedUrl(ref: Ref): Promise<{\n    url: string;\n    method: string;\n  }> {\n    const url = `${this.url}/sign`;\n\n    const res = await fetch(url, {\n      method: \"POST\",\n      body: JSON.stringify(ref),\n      headers: {\n        authorization: `Bearer ${this.accessToken}`,\n        \"content-type\": \"application/json\",\n        accept: \"application/json\",\n      },\n    });\n\n    if (res.status >= 400) {\n      throw new Error(`http-${res.status}`);\n    }\n\n    const json = await res.json();\n\n    return {\n      url: json.url,\n      method: json.method,\n    };\n  }\n\n  // -----------------------\n  // JSON UPLOAD\n  // -----------------------\n\n  async uploadJson(\n    path: string,\n    obj: Record<string, unknown>,\n  ): Promise<{ ok: true }> {\n    const ref = parse(path);\n\n    if (!ref) {\n      throw new Error(\"invalid remote path\");\n    }\n\n    const { url, method } = await this.getSignedUrl({\n      ...ref,\n      method: \"put\",\n      contentType: \"application/json\",\n    });\n\n    const res = await fetch(url, {\n      method,\n      body: JSON.stringify(obj),\n      headers: {\n        \"content-type\": \"application/json\",\n      },\n    });\n\n    if (res.status >= 400) {\n      throw new Error(`http-${res.status}`);\n    }\n\n    return { ok: true };\n  }\n\n  // -----------------------\n  // FILE UPLOAD\n  // -----------------------\n\n  async uploadFile(\n    localPath: string,\n    remotePath: string,\n    contentType = \"application/octet-stream\",\n  ): Promise<{ ok: true }> {\n    const ref = parse(remotePath);\n\n    if (!ref) {\n      throw new Error(\"invalid remote path\");\n    }\n\n    const { url, method } = await this.getSignedUrl({\n      ...ref,\n      method: \"put\",\n      contentType,\n    });\n\n    const stream = createReadStream(localPath);\n\n    const res = await fetch(url, {\n      method,\n      body: stream as any,\n      //duplex: 'half',\n      headers: {\n        \"content-type\": contentType,\n      },\n    });\n\n    if (res.status >= 400) {\n      throw new Error(`http-${res.status}`);\n    }\n\n    return { ok: true };\n  }\n\n  // -----------------------\n  // JSON DOWNLOAD\n  // -----------------------\n\n  async downloadJson<T = Record<string, unknown>>(path: string): Promise<T> {\n    const ref = parse(path);\n\n    if (!ref) {\n      throw new Error(\"invalid remote path\");\n    }\n\n    const { url, method } = await this.getSignedUrl({\n      ...ref,\n      method: \"get\",\n    });\n\n    const res = await fetch(url, {\n      method,\n    });\n\n    if (res.status >= 400) {\n      throw new Error(`http-${res.status}`);\n    }\n\n    return (await res.json()) as T;\n  }\n\n  // -----------------------\n  // FILE DOWNLOAD\n  // -----------------------\n\n  async downloadFile(remotePath: string, localPath: string): Promise<void> {\n    const ref = parse(remotePath);\n\n    if (!ref) {\n      throw new Error(\"invalid remote path\");\n    }\n\n    const { url, method } = await this.getSignedUrl({\n      ...ref,\n      method: \"get\",\n    });\n\n    const res = await fetch(url, {\n      method,\n    });\n\n    if (res.status >= 400) {\n      throw new Error(`http-${res.status}`);\n    }\n\n    if (!res.body) {\n      throw new Error(\"missing response body\");\n    }\n\n    const file = createWriteStream(localPath);\n\n    await pipeline(res.body as any, file);\n  }\n\n  // -----------------------\n  // EXISTS\n  // -----------------------\n\n  async exists(path: string): Promise<boolean> {\n    try {\n      const ref = parse(path);\n\n      if (!ref) {\n        throw new Error(\"invalid remote path\");\n      }\n\n      const { url } = await this.getSignedUrl({\n        ...ref,\n        method: \"get\",\n      });\n\n      const res = await fetch(url, {\n        method: \"HEAD\",\n      });\n\n      return res.status < 400;\n    } catch {\n      return false;\n    }\n  }\n\n  // -----------------------\n  // DELETE\n  // -----------------------\n\n  async delete(path: string): Promise<{ ok: true }> {\n    const ref = parse(path);\n\n    if (!ref) {\n      throw new Error(\"invalid remote path\");\n    }\n\n    const url = `${this.url}/delete`;\n\n    const res = await fetch(url, {\n      method: \"POST\",\n      body: JSON.stringify(ref),\n      headers: {\n        authorization: `Bearer ${this.accessToken}`,\n        \"content-type\": \"application/json\",\n        accept: \"application/json\",\n      },\n    });\n\n    if (res.status >= 400) {\n      throw new Error(`http-${res.status}`);\n    }\n\n    return { ok: true };\n  }\n\n  // -----------------------\n  // LIST\n  // -----------------------\n\n  async list(prefix: string): Promise<string[]> {\n    const ref = parse(prefix);\n\n    if (!ref) {\n      throw new Error(\"invalid remote path\");\n    }\n\n    const url = `${this.url}/list`;\n\n    const res = await fetch(url, {\n      method: \"POST\",\n      body: JSON.stringify({\n        group: ref.group,\n        prefix: ref.key,\n      }),\n      headers: {\n        authorization: `Bearer ${this.accessToken}`,\n        \"content-type\": \"application/json\",\n        accept: \"application/json\",\n      },\n    });\n\n    if (res.status >= 400) {\n      throw new Error(`http-${res.status}`);\n    }\n\n    return await res.json();\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@xgsd/artifact-sdk",
+  "version": "0.0.1",
+  "main": "dist/index.js",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "build": "tsup"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5"
+  }
+}

package/tsup.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: {
+    index: "src/index.ts",
+  },
+  format: ["esm"],
+  dts: true,
+  clean: true,
+  sourcemap: true,
+  target: "es2022",
+});