lambdaimg 0.1.0

package/README.md

@@ -0,0 +1,12 @@
+# lambdaimg
+
+Create deployable LambdaImg apps.
+
+```sh
+bunx lambdaimg create my-images
+cd my-images
+bun install
+bun run deploy
+```
+
+The CLI writes an Alchemy app but does not deploy it automatically.

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+export interface CreateAppOptions {
+    cwd?: string;
+    force?: boolean;
+}
+export interface CreateAppResult {
+    targetDir: string;
+    files: string[];
+}
+export declare function createApp(targetDir: string, options?: CreateAppOptions): Promise<CreateAppResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAKA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAoC1B"}

package/dist/index.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+import { mkdir, readdir, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+export async function createApp(targetDir, options = {}) {
+    if (!targetDir) {
+        throw new Error("A target directory is required.");
+    }
+    const cwd = options.cwd ?? process.cwd();
+    const resolvedTarget = path.resolve(cwd, targetDir);
+    const targetStatus = await getPathStatus(resolvedTarget);
+    if (targetStatus === "file") {
+        throw new Error(`Target exists and is not a directory: ${resolvedTarget}`);
+    }
+    if (targetStatus === "directory" && !options.force) {
+        const entries = await readdir(resolvedTarget);
+        if (entries.length > 0) {
+            throw new Error(`Target directory is not empty: ${resolvedTarget}. Pass --force to write into it.`);
+        }
+    }
+    await mkdir(resolvedTarget, { recursive: true });
+    const packageName = packageNameFromDir(resolvedTarget);
+    const files = appFiles(packageName);
+    await Promise.all(Object.entries(files).map(([filename, contents]) => writeFile(path.join(resolvedTarget, filename), contents)));
+    return {
+        targetDir: resolvedTarget,
+        files: Object.keys(files),
+    };
+}
+async function main(argv = process.argv.slice(2)) {
+    const parsed = parseArgs(argv);
+    if (parsed.help) {
+        process.stdout.write(usage());
+        return;
+    }
+    if (parsed.command !== "create" || !parsed.targetDir) {
+        process.stderr.write(usage());
+        process.exitCode = 1;
+        return;
+    }
+    const result = await createApp(parsed.targetDir, { force: parsed.force });
+    process.stdout.write(`Created LambdaImg app at ${result.targetDir}\n`);
+}
+function parseArgs(argv) {
+    const force = argv.includes("--force");
+    const help = argv.includes("--help") || argv.includes("-h");
+    const positional = argv.filter((arg) => !arg.startsWith("-"));
+    return {
+        command: positional[0],
+        targetDir: positional[1],
+        force,
+        help,
+    };
+}
+async function getPathStatus(targetPath) {
+    try {
+        const stats = await stat(targetPath);
+        return stats.isDirectory() ? "directory" : "file";
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return "missing";
+        }
+        throw error;
+    }
+}
+function packageNameFromDir(targetDir) {
+    const basename = path.basename(targetDir);
+    const normalized = basename
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return normalized || "lambdaimg-app";
+}
+function appFiles(packageName) {
+    return {
+        "package.json": `${JSON.stringify({
+            name: packageName,
+            version: "0.1.0",
+            private: true,
+            type: "module",
+            scripts: {
+                check: "tsc --noEmit -p tsconfig.json",
+                deploy: "alchemy deploy",
+                destroy: "alchemy destroy",
+            },
+            dependencies: {
+                "@lambdaimg/alchemy": "^0.1.0",
+                alchemy: "2.0.0-beta.58",
+                effect: "^4.0.0-beta.90",
+            },
+            devDependencies: {
+                "@effect/platform-bun": "^4.0.0-beta.90",
+                "@types/node": "^24.0.0",
+                typescript: "^5.9.3",
+            },
+        }, null, 2)}\n`,
+        "alchemy.run.ts": `import { ImagesStack } from "@lambdaimg/alchemy";
+import * as Alchemy from "alchemy";
+import * as AWS from "alchemy/AWS";
+import { Stack } from "alchemy/Stack";
+import * as Effect from "effect/Effect";
+
+const STAGE_CONFIG = {
+  dev: {
+    domain: "images.dev.example.com",
+    hostedZoneId: "Z0000000000000",
+  },
+  prod: {
+    domain: "images.example.com",
+    hostedZoneId: "Z0000000000000",
+  },
+} as const;
+
+type ImagesStage = keyof typeof STAGE_CONFIG;
+
+export default Alchemy.Stack(
+  "lambdaimg",
+  {
+    providers: AWS.providers(),
+    state: AWS.state(),
+  },
+  Effect.gen(function* () {
+    const { stage } = yield* Stack;
+    const config = STAGE_CONFIG[stage as ImagesStage];
+    if (!config) {
+      return yield* Effect.die(
+        \`Unknown stage "\${stage}". Expected one of: \${Object.keys(STAGE_CONFIG).join(", ")}\`,
+      );
+    }
+
+    return yield* ImagesStack("Images", config);
+  }),
+);
+`,
+        "tsconfig.json": `${JSON.stringify({
+            compilerOptions: {
+                target: "ES2022",
+                lib: ["ES2022", "DOM"],
+                module: "NodeNext",
+                moduleResolution: "NodeNext",
+                strict: true,
+                skipLibCheck: true,
+                types: ["node"],
+            },
+            include: ["alchemy.run.ts"],
+        }, null, 2)}\n`,
+        ".env.example": "AWS_REGION=us-east-1\nAWS_PROFILE=default\n",
+        ".gitignore": "node_modules\n.alchemy\n.env\n.env.*\n!.env.example\ndist\n",
+        "README.md": `# ${packageName}
+
+Deployable LambdaImg app generated by \`lambdaimg create\`.
+
+## Setup
+
+1. Install dependencies:
+
+   \`\`\`sh
+   bun install
+   \`\`\`
+
+2. Edit \`alchemy.run.ts\` and replace the example domains and hosted zone ids.
+
+3. Configure AWS credentials:
+
+   \`\`\`sh
+   cp .env.example .env
+   \`\`\`
+
+4. Deploy:
+
+   \`\`\`sh
+   bun run deploy
+   \`\`\`
+
+The stack creates an S3 bucket for originals, a Lambda resize function, and a CloudFront distribution for original and resized image URLs.
+`,
+    };
+}
+function usage() {
+    return `Usage:
+  lambdaimg create <dir> [--force]
+
+Commands:
+  create <dir>  Create a deployable LambdaImg Alchemy app.
+
+Options:
+  --force       Write files into a non-empty directory.
+  -h, --help    Show this help message.
+`;
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+function isCliEntrypoint() {
+    const argvPath = process.argv[1];
+    if (!argvPath) {
+        return false;
+    }
+    return path.resolve(argvPath) === fileURLToPath(import.meta.url);
+}
+if (isCliEntrypoint()) {
+    main().catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`${message}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "lambdaimg",
+  "version": "0.1.0",
+  "description": "CLI for creating LambdaImg deployable apps.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jperezrealini/lambdaimg.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "lambdaimg": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "default": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "oxlint && oxfmt --check && tsc --noEmit -p tsconfig.json",
+    "fix": "oxlint --fix && oxfmt",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "@types/bun": "catalog:",
+    "@types/node": "catalog:"
+  }
+}