@letsroti/sourceembed 1.0.0

package/README.md

@@ -0,0 +1,56 @@
+# @letsroti/sourceembed
+
+Store embed JSON (or any raw text) to Cloudflare R2 and get a public URL back.
+
+## Installation
+
+```bash
+npm install @letsroti/sourceembed
+# or
+yarn add @letsroti/sourceembed
+```
+
+## Usage
+
+```typescript
+import { SourceEmbed } from '@letsroti/sourceembed';
+
+const sourceEmbed = new SourceEmbed({
+  accessKeyId: process.env.R2_ACCESS_KEY_ID!,
+  secretAccessKey: process.env.R2_ACCESS_KEY_SECRET!,
+  endpoint: process.env.R2_ENDPOINT_URL!,
+  bucket: 'roti-embed',
+  publicDomain: 'raw.letsroti.com',
+});
+
+// Store a single embed JSON
+const { key, url } = await sourceEmbed.store(JSON.stringify(embedData, null, 2));
+console.log(url); // https://raw.letsroti.com/<uuid>.json
+
+// Store multiple embeds at once
+const results = await sourceEmbed.storeMany(jsonArrayOfStrings);
+```
+
+## Configuration
+
+| Option           | Description                                     |
+| ---------------- | ----------------------------------------------- |
+| `accessKeyId`    | Cloudflare R2 access key ID                     |
+| `secretAccessKey` | Cloudflare R2 secret access key                |
+| `endpoint`       | R2 S3-compatible endpoint URL                   |
+| `bucket`         | R2 bucket name                                  |
+| `publicDomain`   | Public domain for serving files (without `https://`) |
+
+## Environment Variables
+
+Set these in your `.env` file (never commit credentials):
+
+```env
+R2_ACCESS_KEY_ID=your_access_key_id
+R2_ACCESS_KEY_SECRET=your_secret_access_key
+R2_ENDPOINT_URL=https://your-account-id.r2.cloudflarestorage.com
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,40 @@
+interface SourceEmbedOptions {
+    /** Cloudflare R2 access key ID */
+    accessKeyId: string;
+    /** Cloudflare R2 secret access key */
+    secretAccessKey: string;
+    /** Cloudflare R2 S3-compatible endpoint URL */
+    endpoint: string;
+    /** R2 bucket name */
+    bucket: string;
+    /** Public domain for serving files (without protocol) */
+    publicDomain: string;
+}
+interface StoreResult {
+    /** The unique key/filename of the stored object */
+    key: string;
+    /** The full public URL to access the stored content */
+    url: string;
+}
+declare class SourceEmbed {
+    private readonly s3;
+    private readonly bucket;
+    private readonly publicDomain;
+    constructor(options: SourceEmbedOptions);
+    /**
+     * Stores raw text (typically embed JSON) in R2 and returns a public URL.
+     * @param rawText - The text content to store
+     * @param extension - File extension (default: 'json')
+     * @returns The key and public URL of the stored object
+     */
+    store(rawText: string, extension?: string): Promise<StoreResult>;
+    /**
+     * Stores multiple raw texts in parallel.
+     * @param rawTexts - Array of text content to store
+     * @param extension - File extension (default: 'json')
+     * @returns Array of settled results (fulfilled with StoreResult or rejected with error)
+     */
+    storeMany(rawTexts: string[], extension?: string): Promise<PromiseSettledResult<StoreResult>[]>;
+}
+
+export { SourceEmbed, type SourceEmbedOptions, type StoreResult };

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+interface SourceEmbedOptions {
+    /** Cloudflare R2 access key ID */
+    accessKeyId: string;
+    /** Cloudflare R2 secret access key */
+    secretAccessKey: string;
+    /** Cloudflare R2 S3-compatible endpoint URL */
+    endpoint: string;
+    /** R2 bucket name */
+    bucket: string;
+    /** Public domain for serving files (without protocol) */
+    publicDomain: string;
+}
+interface StoreResult {
+    /** The unique key/filename of the stored object */
+    key: string;
+    /** The full public URL to access the stored content */
+    url: string;
+}
+declare class SourceEmbed {
+    private readonly s3;
+    private readonly bucket;
+    private readonly publicDomain;
+    constructor(options: SourceEmbedOptions);
+    /**
+     * Stores raw text (typically embed JSON) in R2 and returns a public URL.
+     * @param rawText - The text content to store
+     * @param extension - File extension (default: 'json')
+     * @returns The key and public URL of the stored object
+     */
+    store(rawText: string, extension?: string): Promise<StoreResult>;
+    /**
+     * Stores multiple raw texts in parallel.
+     * @param rawTexts - Array of text content to store
+     * @param extension - File extension (default: 'json')
+     * @returns Array of settled results (fulfilled with StoreResult or rejected with error)
+     */
+    storeMany(rawTexts: string[], extension?: string): Promise<PromiseSettledResult<StoreResult>[]>;
+}
+
+export { SourceEmbed, type SourceEmbedOptions, type StoreResult };

package/dist/index.js

@@ -0,0 +1,79 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SourceEmbed: () => SourceEmbed
+});
+module.exports = __toCommonJS(index_exports);
+var import_client_s3 = require("@aws-sdk/client-s3");
+var import_node_crypto = require("crypto");
+var SourceEmbed = class {
+  s3;
+  bucket;
+  publicDomain;
+  constructor(options) {
+    this.bucket = options.bucket;
+    this.publicDomain = options.publicDomain;
+    this.s3 = new import_client_s3.S3Client({
+      region: "auto",
+      endpoint: options.endpoint,
+      credentials: {
+        accessKeyId: options.accessKeyId,
+        secretAccessKey: options.secretAccessKey
+      }
+    });
+  }
+  /**
+   * Stores raw text (typically embed JSON) in R2 and returns a public URL.
+   * @param rawText - The text content to store
+   * @param extension - File extension (default: 'json')
+   * @returns The key and public URL of the stored object
+   */
+  async store(rawText, extension = "json") {
+    const key = `${(0, import_node_crypto.randomUUID)()}.${extension}`;
+    await this.s3.send(
+      new import_client_s3.PutObjectCommand({
+        Bucket: this.bucket,
+        Key: key,
+        Body: rawText,
+        ContentType: extension === "json" ? "application/json" : "text/plain"
+      })
+    );
+    return {
+      key,
+      url: `https://${this.publicDomain}/${key}`
+    };
+  }
+  /**
+   * Stores multiple raw texts in parallel.
+   * @param rawTexts - Array of text content to store
+   * @param extension - File extension (default: 'json')
+   * @returns Array of settled results (fulfilled with StoreResult or rejected with error)
+   */
+  async storeMany(rawTexts, extension = "json") {
+    return Promise.allSettled(rawTexts.map((text) => this.store(text, extension)));
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SourceEmbed
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { PutObjectCommand, S3Client } from '@aws-sdk/client-s3';\r\nimport { randomUUID } from 'node:crypto';\r\n\r\nexport interface SourceEmbedOptions {\r\n\t/** Cloudflare R2 access key ID */\r\n\taccessKeyId: string;\r\n\t/** Cloudflare R2 secret access key */\r\n\tsecretAccessKey: string;\r\n\t/** Cloudflare R2 S3-compatible endpoint URL */\r\n\tendpoint: string;\r\n\t/** R2 bucket name */\r\n\tbucket: string;\r\n\t/** Public domain for serving files (without protocol) */\r\n\tpublicDomain: string;\r\n}\r\n\r\nexport interface StoreResult {\r\n\t/** The unique key/filename of the stored object */\r\n\tkey: string;\r\n\t/** The full public URL to access the stored content */\r\n\turl: string;\r\n}\r\n\r\nexport class SourceEmbed {\r\n\tprivate readonly s3: S3Client;\r\n\tprivate readonly bucket: string;\r\n\tprivate readonly publicDomain: string;\r\n\r\n\tpublic constructor(options: SourceEmbedOptions) {\r\n\t\tthis.bucket = options.bucket;\r\n\t\tthis.publicDomain = options.publicDomain;\r\n\r\n\t\tthis.s3 = new S3Client({\r\n\t\t\tregion: 'auto',\r\n\t\t\tendpoint: options.endpoint,\r\n\t\t\tcredentials: {\r\n\t\t\t\taccessKeyId: options.accessKeyId,\r\n\t\t\t\tsecretAccessKey: options.secretAccessKey,\r\n\t\t\t},\r\n\t\t});\r\n\t}\r\n\r\n\t/**\r\n\t * Stores raw text (typically embed JSON) in R2 and returns a public URL.\r\n\t * @param rawText - The text content to store\r\n\t * @param extension - File extension (default: 'json')\r\n\t * @returns The key and public URL of the stored object\r\n\t */\r\n\tpublic async store(rawText: string, extension = 'json'): Promise<StoreResult> {\r\n\t\tconst key = `${randomUUID()}.${extension}`;\r\n\r\n\t\tawait this.s3.send(\r\n\t\t\tnew PutObjectCommand({\r\n\t\t\t\tBucket: this.bucket,\r\n\t\t\t\tKey: key,\r\n\t\t\t\tBody: rawText,\r\n\t\t\t\tContentType: extension === 'json' ? 'application/json' : 'text/plain',\r\n\t\t\t})\r\n\t\t);\r\n\r\n\t\treturn {\r\n\t\t\tkey,\r\n\t\t\turl: `https://${this.publicDomain}/${key}`,\r\n\t\t};\r\n\t}\r\n\r\n\t/**\r\n\t * Stores multiple raw texts in parallel.\r\n\t * @param rawTexts - Array of text content to store\r\n\t * @param extension - File extension (default: 'json')\r\n\t * @returns Array of settled results (fulfilled with StoreResult or rejected with error)\r\n\t */\r\n\tpublic async storeMany(rawTexts: string[], extension = 'json'): Promise<PromiseSettledResult<StoreResult>[]> {\r\n\t\treturn Promise.allSettled(rawTexts.map((text) => this.store(text, extension)));\r\n\t}\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAA2C;AAC3C,yBAA2B;AAsBpB,IAAM,cAAN,MAAkB;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EAEV,YAAY,SAA6B;AAC/C,SAAK,SAAS,QAAQ;AACtB,SAAK,eAAe,QAAQ;AAE5B,SAAK,KAAK,IAAI,0BAAS;AAAA,MACtB,QAAQ;AAAA,MACR,UAAU,QAAQ;AAAA,MAClB,aAAa;AAAA,QACZ,aAAa,QAAQ;AAAA,QACrB,iBAAiB,QAAQ;AAAA,MAC1B;AAAA,IACD,CAAC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAa,MAAM,SAAiB,YAAY,QAA8B;AAC7E,UAAM,MAAM,OAAG,+BAAW,CAAC,IAAI,SAAS;AAExC,UAAM,KAAK,GAAG;AAAA,MACb,IAAI,kCAAiB;AAAA,QACpB,QAAQ,KAAK;AAAA,QACb,KAAK;AAAA,QACL,MAAM;AAAA,QACN,aAAa,cAAc,SAAS,qBAAqB;AAAA,MAC1D,CAAC;AAAA,IACF;AAEA,WAAO;AAAA,MACN;AAAA,MACA,KAAK,WAAW,KAAK,YAAY,IAAI,GAAG;AAAA,IACzC;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAa,UAAU,UAAoB,YAAY,QAAsD;AAC5G,WAAO,QAAQ,WAAW,SAAS,IAAI,CAAC,SAAS,KAAK,MAAM,MAAM,SAAS,CAAC,CAAC;AAAA,EAC9E;AACD;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,54 @@
+// src/index.ts
+import { PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
+import { randomUUID } from "crypto";
+var SourceEmbed = class {
+  s3;
+  bucket;
+  publicDomain;
+  constructor(options) {
+    this.bucket = options.bucket;
+    this.publicDomain = options.publicDomain;
+    this.s3 = new S3Client({
+      region: "auto",
+      endpoint: options.endpoint,
+      credentials: {
+        accessKeyId: options.accessKeyId,
+        secretAccessKey: options.secretAccessKey
+      }
+    });
+  }
+  /**
+   * Stores raw text (typically embed JSON) in R2 and returns a public URL.
+   * @param rawText - The text content to store
+   * @param extension - File extension (default: 'json')
+   * @returns The key and public URL of the stored object
+   */
+  async store(rawText, extension = "json") {
+    const key = `${randomUUID()}.${extension}`;
+    await this.s3.send(
+      new PutObjectCommand({
+        Bucket: this.bucket,
+        Key: key,
+        Body: rawText,
+        ContentType: extension === "json" ? "application/json" : "text/plain"
+      })
+    );
+    return {
+      key,
+      url: `https://${this.publicDomain}/${key}`
+    };
+  }
+  /**
+   * Stores multiple raw texts in parallel.
+   * @param rawTexts - Array of text content to store
+   * @param extension - File extension (default: 'json')
+   * @returns Array of settled results (fulfilled with StoreResult or rejected with error)
+   */
+  async storeMany(rawTexts, extension = "json") {
+    return Promise.allSettled(rawTexts.map((text) => this.store(text, extension)));
+  }
+};
+export {
+  SourceEmbed
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { PutObjectCommand, S3Client } from '@aws-sdk/client-s3';\r\nimport { randomUUID } from 'node:crypto';\r\n\r\nexport interface SourceEmbedOptions {\r\n\t/** Cloudflare R2 access key ID */\r\n\taccessKeyId: string;\r\n\t/** Cloudflare R2 secret access key */\r\n\tsecretAccessKey: string;\r\n\t/** Cloudflare R2 S3-compatible endpoint URL */\r\n\tendpoint: string;\r\n\t/** R2 bucket name */\r\n\tbucket: string;\r\n\t/** Public domain for serving files (without protocol) */\r\n\tpublicDomain: string;\r\n}\r\n\r\nexport interface StoreResult {\r\n\t/** The unique key/filename of the stored object */\r\n\tkey: string;\r\n\t/** The full public URL to access the stored content */\r\n\turl: string;\r\n}\r\n\r\nexport class SourceEmbed {\r\n\tprivate readonly s3: S3Client;\r\n\tprivate readonly bucket: string;\r\n\tprivate readonly publicDomain: string;\r\n\r\n\tpublic constructor(options: SourceEmbedOptions) {\r\n\t\tthis.bucket = options.bucket;\r\n\t\tthis.publicDomain = options.publicDomain;\r\n\r\n\t\tthis.s3 = new S3Client({\r\n\t\t\tregion: 'auto',\r\n\t\t\tendpoint: options.endpoint,\r\n\t\t\tcredentials: {\r\n\t\t\t\taccessKeyId: options.accessKeyId,\r\n\t\t\t\tsecretAccessKey: options.secretAccessKey,\r\n\t\t\t},\r\n\t\t});\r\n\t}\r\n\r\n\t/**\r\n\t * Stores raw text (typically embed JSON) in R2 and returns a public URL.\r\n\t * @param rawText - The text content to store\r\n\t * @param extension - File extension (default: 'json')\r\n\t * @returns The key and public URL of the stored object\r\n\t */\r\n\tpublic async store(rawText: string, extension = 'json'): Promise<StoreResult> {\r\n\t\tconst key = `${randomUUID()}.${extension}`;\r\n\r\n\t\tawait this.s3.send(\r\n\t\t\tnew PutObjectCommand({\r\n\t\t\t\tBucket: this.bucket,\r\n\t\t\t\tKey: key,\r\n\t\t\t\tBody: rawText,\r\n\t\t\t\tContentType: extension === 'json' ? 'application/json' : 'text/plain',\r\n\t\t\t})\r\n\t\t);\r\n\r\n\t\treturn {\r\n\t\t\tkey,\r\n\t\t\turl: `https://${this.publicDomain}/${key}`,\r\n\t\t};\r\n\t}\r\n\r\n\t/**\r\n\t * Stores multiple raw texts in parallel.\r\n\t * @param rawTexts - Array of text content to store\r\n\t * @param extension - File extension (default: 'json')\r\n\t * @returns Array of settled results (fulfilled with StoreResult or rejected with error)\r\n\t */\r\n\tpublic async storeMany(rawTexts: string[], extension = 'json'): Promise<PromiseSettledResult<StoreResult>[]> {\r\n\t\treturn Promise.allSettled(rawTexts.map((text) => this.store(text, extension)));\r\n\t}\r\n}\r\n"],"mappings":";AAAA,SAAS,kBAAkB,gBAAgB;AAC3C,SAAS,kBAAkB;AAsBpB,IAAM,cAAN,MAAkB;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EAEV,YAAY,SAA6B;AAC/C,SAAK,SAAS,QAAQ;AACtB,SAAK,eAAe,QAAQ;AAE5B,SAAK,KAAK,IAAI,SAAS;AAAA,MACtB,QAAQ;AAAA,MACR,UAAU,QAAQ;AAAA,MAClB,aAAa;AAAA,QACZ,aAAa,QAAQ;AAAA,QACrB,iBAAiB,QAAQ;AAAA,MAC1B;AAAA,IACD,CAAC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAa,MAAM,SAAiB,YAAY,QAA8B;AAC7E,UAAM,MAAM,GAAG,WAAW,CAAC,IAAI,SAAS;AAExC,UAAM,KAAK,GAAG;AAAA,MACb,IAAI,iBAAiB;AAAA,QACpB,QAAQ,KAAK;AAAA,QACb,KAAK;AAAA,QACL,MAAM;AAAA,QACN,aAAa,cAAc,SAAS,qBAAqB;AAAA,MAC1D,CAAC;AAAA,IACF;AAEA,WAAO;AAAA,MACN;AAAA,MACA,KAAK,WAAW,KAAK,YAAY,IAAI,GAAG;AAAA,IACzC;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAa,UAAU,UAAoB,YAAY,QAAsD;AAC5G,WAAO,QAAQ,WAAW,SAAS,IAAI,CAAC,SAAS,KAAK,MAAM,MAAM,SAAS,CAAC,CAAC;AAAA,EAC9E;AACD;","names":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+	"name": "@letsroti/sourceembed",
+	"version": "1.0.0",
+	"description": "Store embed JSON to Cloudflare R2 and return a public URL",
+	"main": "dist/index.js",
+	"module": "dist/index.mjs",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.mts",
+				"default": "./dist/index.mjs"
+			},
+			"require": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			}
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsup",
+		"dev": "tsup --watch",
+		"lint": "eslint src --fix",
+		"typecheck": "tsc --noEmit",
+		"prepublishOnly": "npm run build"
+	},
+	"keywords": [
+		"discord",
+		"embed",
+		"sourceembed",
+		"cloudflare",
+		"r2"
+	],
+	"license": "MIT",
+	"dependencies": {
+		"@aws-sdk/client-s3": "^3.700.0"
+	},
+	"devDependencies": {
+		"@types/node": "^25.4.0",
+		"tsup": "^8.0.0",
+		"typescript": "^5.5.0"
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	}
+}