create-cloud-db 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -2,6 +2,4 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-### [1.0.2](https://github.com/vtempest/Svelte-Starter-DOCS/compare/v1.0.1...v1.0.2) (2025-12-22)
-
-### [1.0.1](https://github.com/vtempest/Svelte-Starter-DOCS/compare/v0.9.2...v1.0.1) (2025-12-22)
+### [1.0.3](https://github.com/vtempest/Svelte-Starter-DOCS/compare/v1.0.2...v1.0.3) (2025-12-22)

package/README.md

@@ -0,0 +1,86 @@
+# create-cloud-db
+
+`create-cloud-db` is a small CLI that creates a Turso database and manages the `TURSO_DATABASE_URL` and `TURSO_AUTH_TOKEN` values in your local `.env` file.
+
+It is designed for quick local setup so you can be ready to connect from Node, frameworks, or serverless environments with minimal manual configuration.
+
+## Installation
+
+You must first login to turso with:
+
+```bash
+bun i -g turso
+turso auth login
+
+# or
+bun x turso auth login
+```
+
+Then run:
+
+```bash
+# will ask for name
+npx create-cloud-db
+
+npx create-cloud-db [myapp-db]
+```
+
+Or install globally:
+
+```bash
+npm install -g create-cloud-db
+create-cloud-db myapp-db
+```
+
+## What it does
+
+When you run the command, the CLI:
+
+1. Ensures you are logged into Turso via `turso auth login`.  
+2. Creates a Turso database if it does not already exist.  
+3. Generates a database URL and an auth token via the Turso CLI.  
+4. Overwrites (not appends) the `TURSO_DATABASE_URL` and `TURSO_AUTH_TOKEN` entries in your local `.env` file.  
+
+After running, your `.env` file will contain something like:
+
+```env
+TURSO_DATABASE_URL=libsql://your-db-name.region.turso.io
+TURSO_AUTH_TOKEN=eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9...
+```
+
+## Add to package.json
+
+```json
+    "db:create": "create-cloud-db",
+    "db:generate": "drizzle-kit generate",
+    "db:push": "drizzle-kit push",
+    "db:studio": "drizzle-kit studio",
+```
+
+## Environment file behavior
+
+- The CLI reads your existing `.env` file if present.  
+- It updates or inserts `TURSO_DATABASE_URL` and `TURSO_AUTH_TOKEN` keys.  
+- The `.env` file is rewritten, so old placeholder values are removed and replaced with valid values.
+
+### Example with Drizzle
+
+```ts
+// drizzle.config.ts
+
+import { defineConfig } from 'drizzle-kit';
+
+export default defineConfig({
+  dialect: 'turso',
+  schema: './src/lib/db/schema.ts',
+  out: './drizzle',
+  dbCredentials: {
+    url: process.env.TURSO_DATABASE_URL || 'file:./localdb.sqlite',
+    authToken: process.env.TURSO_AUTH_TOKEN,
+  },
+});
+```
+
+## 📝 License
+
+MIT License - Star this repo so it can grow features! 🌟

package/create-cloud-db.js

@@ -53,38 +53,69 @@ async function ensureLogin() {
   }
 }
 
-// Parse env file into plain object
+// Parse env file into array of line objects to preserve comments/whitespace
 function readEnvFile(filePath) {
-  if (!fs.existsSync(filePath)) return {};
+  if (!fs.existsSync(filePath)) return [];
   const content = fs.readFileSync(filePath, "utf8");
   const lines = content.split(/\r?\n/);
 
-  const env = {};
-  for (const line of lines) {
+  return lines.map((line) => {
     const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
+
+    // Blank line
+    if (!trimmed) {
+      return { type: 'blank', line };
+    }
+
+    // Comment line
+    if (trimmed.startsWith("#")) {
+      return { type: 'comment', line };
+    }
+
+    // Key-value pair
     const idx = trimmed.indexOf("=");
-    if (idx === -1) continue;
+    if (idx === -1) {
+      return { type: 'other', line };
+    }
+
     const key = trimmed.slice(0, idx).trim();
     let value = trimmed.slice(idx + 1).trim();
+
+    // Remove quotes from value if present
     if (
       (value.startsWith('"') && value.endsWith('"')) ||
       (value.startsWith("'") && value.endsWith("'"))
     ) {
       value = value.slice(1, -1);
     }
-    env[key] = value;
-  }
-  return env;
+
+    return { type: 'keyvalue', key, value, line };
+  });
 }
 
-// Write env object back to file, overwriting file completely
-function writeEnvFile(filePath, envObj) {
-  const lines = [];
-  for (const [key, value] of Object.entries(envObj)) {
-    lines.push(`${key}=${value}`);
+// Write env array back to file, preserving comments and blank lines
+function writeEnvFile(filePath, lineArray, updates) {
+  const updatedLines = lineArray.map((item) => {
+    // If this is a key-value pair and we have an update for it
+    if (item.type === 'keyvalue' && updates[item.key] !== undefined) {
+      return `${item.key}=${updates[item.key]}`;
+    }
+    // Otherwise, preserve the original line
+    return item.line;
+  });
+
+  // Add any new keys that weren't in the original file
+  const existingKeys = new Set(
+    lineArray.filter(item => item.type === 'keyvalue').map(item => item.key)
+  );
+
+  for (const [key, value] of Object.entries(updates)) {
+    if (!existingKeys.has(key)) {
+      updatedLines.push(`${key}=${value}`);
+    }
   }
-  fs.writeFileSync(filePath, lines.join("\n") + "\n");
+
+  fs.writeFileSync(filePath, updatedLines.join("\n") + "\n");
 }
 
 async function main() {
@@ -100,9 +131,17 @@ async function main() {
     process.exit(1);
   }
 
-  // Load existing .env into object
+  // Load existing .env into line array
   const envPath = path.join(process.cwd(), ".env");
-  const envObj = readEnvFile(envPath);
+  const envLines = readEnvFile(envPath);
+
+  // Extract current values from line array
+  const envObj = {};
+  envLines.forEach(item => {
+    if (item.type === 'keyvalue') {
+      envObj[item.key] = item.value;
+    }
+  });
 
   const existingUrl = envObj.TURSO_DATABASE_URL || process.env.TURSO_DATABASE_URL;
   const existingToken = envObj.TURSO_AUTH_TOKEN || process.env.TURSO_AUTH_TOKEN;
@@ -137,8 +176,8 @@ async function main() {
   process.env.TURSO_DATABASE_URL = dbUrl;
   process.env.TURSO_AUTH_TOKEN = authToken;
 
-  // Overwrite .env with updated values (no duplicates, no stale “not logged in” values)
-  writeEnvFile(envPath, envObj);
+  // Overwrite .env with updated values (no duplicates, no stale "not logged in" values)
+  writeEnvFile(envPath, envLines, envObj);
 
   console.log("\nUpdated Turso environment variables (overwritten in .env):");
   console.log(`TURSO_DATABASE_URL=${process.env.TURSO_DATABASE_URL}`);

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "create-cloud-db",
-  "description": "CLI to create a Turso database and manage TURSO_* env vars",
+  "description": "CLI to create a Turso database and write TURSO_* env vars to .env file",
   "type": "module",
   "author": "vtempest",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "main": "create-cloud-db.js",
   "bin": {
     "create-cloud-db": "./create-cloud-db.js"

package/.env

@@ -1,6 +0,0 @@
-
-TURSO_DATABASE_URL=You are not logged in, please login with turso auth login before running other commands.
-TURSO_AUTH_TOKEN=You are not logged in, please login with turso auth login before running other commands.
-
-TURSO_DATABASE_URL=libsql://lol-xfreestar10.aws-us-west-2.turso.io
-TURSO_AUTH_TOKEN=eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjYzNzYwNjEsImlkIjoiNDUyY2M2NzUtODk2Ny00Njc5LTk4MTItNTA2MGY1YmEyMDljIiwicmlkIjoiZjdkMWFhZTMtYzEzZC00OTEyLWFjYTAtNWRkY2Y5MTZkOWI5In0.loooOtvg-8fYzl_bi032Y32KGdDjOZhbKXdGFQLfrzt7Jbu9vDLY9I8KrUtOPprRFRrCHExXkfQtIg6xmt_XCg