cf-envsync 0.1.0

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "cf-envsync",
+  "version": "0.1.0",
+  "description": "Sync .env files to Cloudflare Workers secrets, .dev.vars, and more",
+  "type": "module",
+  "exports": {
+    ".": "./src/define-config.ts"
+  },
+  "bin": {
+    "envsync": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "src/define-config.ts",
+    "src/types"
+  ],
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node --external jiti",
+    "prepublishOnly": "bun run build",
+    "test": "bun test"
+  },
+  "peerDependencies": {
+    "wrangler": ">=3"
+  },
+  "peerDependenciesMeta": {
+    "wrangler": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@dotenvx/dotenvx": "^1.52.0",
+    "citty": "^0.2.1",
+    "consola": "^3.4.2",
+    "jiti": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22"
+  }
+}

package/src/define-config.ts

@@ -0,0 +1,30 @@
+import type { EnvSyncConfig } from "./types/config.ts";
+
+/**
+ * Define envsync configuration with full type checking and editor support.
+ *
+ * @example
+ * ```ts
+ * // envsync.config.ts
+ * import { defineConfig } from "cf-envsync";
+ *
+ * export default defineConfig({
+ *   environments: ["local", "staging", "production"],
+ *   envFiles: { pattern: ".env.{env}", local: ".env.local", perApp: true },
+ *   encryption: "dotenvx",
+ *   apps: {
+ *     api: {
+ *       path: "apps/api",
+ *       workers: { staging: "my-api-staging", production: "my-api" },
+ *       secrets: ["DATABASE_URL"],
+ *       vars: ["API_URL"],
+ *     },
+ *   },
+ * });
+ * ```
+ */
+export function defineConfig(config: EnvSyncConfig): EnvSyncConfig {
+  return config;
+}
+
+export type { EnvSyncConfig, AppConfig } from "./types/config.ts";

package/src/types/config.ts

@@ -0,0 +1,65 @@
+/** Root configuration (envsync.json) */
+export interface EnvSyncConfig {
+  /** Supported environments */
+  environments: string[];
+
+  /** .env file mapping rules */
+  envFiles: {
+    /** Pattern for env files, e.g. ".env.{env}". local falls back to ".env" */
+    pattern: string;
+    /** Per-developer override file (gitignored), only for local env */
+    local: string;
+    /** Allow per-app .env.{env} files */
+    perApp: boolean;
+  };
+
+  /** Encryption method */
+  encryption: "dotenvx" | "none";
+
+  /** App definitions */
+  apps: Record<string, AppConfig>;
+
+  /** Shared secret keys (same value across multiple apps within an env) */
+  shared?: string[];
+
+  /** Per-developer local override configuration */
+  local?: {
+    /** Keys that each developer must set locally */
+    overrides?: string[];
+    /** Per-app developer override keys */
+    perApp?: Record<string, string[]>;
+  };
+}
+
+/** Configuration for a single app/worker */
+export interface AppConfig {
+  /** Path to app directory relative to project root */
+  path: string;
+  /** Cloudflare Worker names per environment */
+  workers: Record<string, string>;
+  /** Secret keys for this app (pushed via wrangler secret) */
+  secrets?: string[];
+  /** Var keys for this app (non-secret env vars) */
+  vars?: string[];
+}
+
+/** Resolved config after defaults and path resolution */
+export interface ResolvedConfig {
+  /** Absolute path to project root */
+  projectRoot: string;
+  /** Original config */
+  raw: EnvSyncConfig;
+  /** Available environments */
+  environments: string[];
+  /** Resolved app configs */
+  apps: Record<string, ResolvedAppConfig>;
+}
+
+export interface ResolvedAppConfig extends AppConfig {
+  /** App name (key from config) */
+  name: string;
+  /** Absolute path to app directory */
+  absolutePath: string;
+  /** All keys this app needs (secrets + vars + local overrides) */
+  allKeys: string[];
+}

package/src/types/env.ts

@@ -0,0 +1,50 @@
+/** Simple key-value env map */
+export type EnvMap = Record<string, string>;
+
+/** An env entry with source tracking */
+export interface EnvEntry {
+  key: string;
+  value: string;
+  /** Where this value came from (file path or description) */
+  source: string;
+}
+
+/** Diff between two env states */
+export interface DiffEntry {
+  key: string;
+  status: "added" | "removed" | "changed" | "unchanged";
+  localValue?: string;
+  remoteValue?: string;
+}
+
+/** Diff between two environments */
+export interface EnvDiffEntry {
+  key: string;
+  status: "match" | "differs" | "missing-left" | "missing-right";
+  leftValue?: string;
+  rightValue?: string;
+}
+
+/** Validation result for a single app in one environment */
+export interface ValidationResult {
+  app: string;
+  environment: string;
+  /** Keys present in .env.example but missing from resolved env */
+  missingKeys: string[];
+  /** Keys present in resolved env but not in .env.example */
+  extraKeys: string[];
+  /** Per-dev override keys that are missing from .env.local */
+  missingOverrides: string[];
+  /** Overall pass/fail */
+  valid: boolean;
+}
+
+/** Result of loading and merging env layers */
+export interface ResolvedEnv {
+  /** Final merged key-value pairs */
+  entries: EnvEntry[];
+  /** Map form for easy access */
+  map: EnvMap;
+  /** Sources that were loaded (in order) */
+  layers: string[];
+}