alchemy 0.3.0 → 0.3.1

package/lib/ai/typescript-file.js

@@ -1,9 +1,6 @@
 import { generateText } from "ai";
-import fs from "node:fs/promises";
-import path from "node:path";
-import prettier from "prettier";
+import { StaticTypeScriptFile } from "../fs/static-typescript-file";
 import { Resource } from "../resource";
-import { ignore } from "../util/ignore";
 import { createModel } from "./client";
 /**
  * Default system prompt for TypeScript file generation
@@ -75,18 +72,9 @@ const DEFAULT_TS_SYSTEM_PROMPT = "You are a TypeScript code generator. Create Ty
  * });
  */
 export const TypeScriptFile = Resource("ai::TypeScriptFile", async function (id, props) {
-    // Ensure directory exists
-    await fs.mkdir(path.dirname(props.path), { recursive: true });
+    // Handle delete phase
     if (this.phase === "delete") {
-        try {
-            await fs.unlink(props.path);
-        }
-        catch (error) {
-            // Ignore if file doesn't exist
-            if (error.code !== "ENOENT") {
-                throw error;
-            }
-        }
+        // StaticTypeScriptFile will handle the deletion
         return this.destroy();
     }
     // Use provided system prompt or default
@@ -121,33 +109,14 @@ export const TypeScriptFile = Resource("ai::TypeScriptFile", async function (id,
         }
         code = retryResult.code;
     }
-    // Format the code with Prettier
-    try {
-        // Set default parser to typescript
-        const prettierOptions = {
-            parser: "typescript",
-            ...props.prettierConfig,
-        };
-        // Format the code
-        code = await prettier.format(code, prettierOptions);
-    }
-    catch (error) {
-        // If Prettier formatting fails, just use the unformatted code
-        console.warn("Failed to format TypeScript code with Prettier:", error);
-    }
-    if (this.phase === "update" && props.path !== this.props.path) {
-        await ignore("ENOENT", () => fs.unlink(this.props.path));
-    }
-    // Write content to file
-    await fs.writeFile(props.path, code);
-    // Get file stats for timestamps
-    const stats = await fs.stat(props.path);
+    // Use StaticTypeScriptFile to create/update the file
+    const file = await StaticTypeScriptFile("file", props.path, code);
     // Return the resource
     return this({
         ...props,
-        content: code,
-        createdAt: stats.birthtimeMs,
-        updatedAt: stats.mtimeMs,
+        content: file.content,
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
     });
 });
 /**

package/lib/ai/vue-file.js

@@ -1,8 +1,6 @@
 import { generateText } from "ai";
-import fs from "node:fs/promises";
-import path from "node:path";
+import { StaticVueFile } from "../fs/static-vue-file";
 import { Resource } from "../resource";
-import { ignore } from "../util/ignore";
 import { createModel } from "./client";
 /**
  * Default system prompt for Vue file generation
@@ -66,18 +64,8 @@ const DEFAULT_VUE_SYSTEM_PROMPT = "You are a Vue component generator. Create a s
  * });
  */
 export const VueFile = Resource("ai::VueFile", async function (id, props) {
-    // Ensure directory exists
-    await fs.mkdir(path.dirname(props.path), { recursive: true });
+    // Handle deletion phase
     if (this.phase === "delete") {
-        try {
-            await fs.unlink(props.path);
-        }
-        catch (error) {
-            // Ignore if file doesn't exist
-            if (error.code !== "ENOENT") {
-                throw error;
-            }
-        }
         return this.destroy();
     }
     // Use provided system prompt or default
@@ -112,19 +100,14 @@ export const VueFile = Resource("ai::VueFile", async function (id, props) {
         }
         code = retryResult.code;
     }
-    if (this.phase === "update" && props.path !== this.props.path) {
-        await ignore("ENOENT", () => fs.unlink(this.props.path));
-    }
-    // Write content to file
-    await fs.writeFile(props.path, code);
-    // Get file stats for timestamps
-    const stats = await fs.stat(props.path);
+    // Use StaticVueFile to create/update the file
+    const file = await StaticVueFile("file", props.path, code);
     // Return the resource
     return this({
         ...props,
-        content: code,
-        createdAt: stats.birthtimeMs,
-        updatedAt: stats.mtimeMs,
+        content: file.content,
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
     });
 });
 /**

package/lib/ai/yaml-file.js

@@ -1,8 +1,6 @@
 import { generateObject, generateText } from "ai";
-import fs from "node:fs/promises";
-import path from "node:path";
+import { StaticYamlFile } from "../fs/static-yaml-file";
 import { Resource } from "../resource";
-import { ignore } from "../util/ignore";
 import { ark } from "./ark";
 import { createModel } from "./client";
 /**
@@ -96,29 +94,10 @@ const DEFAULT_YAML_SYSTEM_PROMPT = "You are a YAML generator. Create valid YAML
  * });
  */
 export const YAMLFile = Resource("ai::YAMLFile", async function (id, props) {
-    // Ensure directory exists
-    await fs.mkdir(path.dirname(props.path), { recursive: true });
+    // Handle deletion phase
     if (this.phase === "delete") {
-        try {
-            await fs.unlink(props.path);
-        }
-        catch (error) {
-            // Ignore if file doesn't exist
-            if (error.code !== "ENOENT") {
-                throw error;
-            }
-        }
         return this.destroy();
     }
-    // Dynamic import js-yaml to avoid dependency issues
-    // This allows the code to work even if js-yaml is not installed
-    let yaml;
-    try {
-        yaml = await import("yaml");
-    }
-    catch (err) {
-        throw new Error("The 'yaml' package is required for the YAMLFile resource. Please install it with: bun add yaml");
-    }
     let yamlContent;
     let yamlObject;
     // Check if schema is provided
@@ -136,15 +115,9 @@ export const YAMLFile = Resource("ai::YAMLFile", async function (id, props) {
                 : { temperature: props.temperature }),
         });
         yamlObject = object;
-        // Convert object to YAML
-        try {
-            yamlContent = yaml.stringify(yamlObject, {
-                indent: 2,
-            });
-        }
-        catch (error) {
-            throw new Error(`Failed to convert object to YAML: ${error.message}`);
-        }
+        // Let StaticYamlFile handle the YAML conversion
+        const file = await StaticYamlFile("file", props.path, yamlObject);
+        yamlContent = file.content;
     }
     else {
         // Use fence-based extraction
@@ -181,29 +154,20 @@ export const YAMLFile = Resource("ai::YAMLFile", async function (id, props) {
             content = retryResult.content;
         }
         yamlContent = content;
-        // Parse YAML to validate and get object representation
-        try {
-            yamlObject = yaml.parse(yamlContent);
-        }
-        catch (error) {
-            throw new Error(`Failed to parse YAML: ${error.message}`);
-        }
-    }
-    if (this.phase === "update" && props.path !== this.props.path) {
-        await ignore("ENOENT", () => fs.unlink(this.props.path));
+        // Create the file with the string content
+        const file = await StaticYamlFile("file", props.path, yamlContent);
+        // We need to parse the YAML to get the object representation
+        const yaml = await import("yaml");
+        yamlObject = yaml.parse(yamlContent);
     }
-    // Write content to file
-    await fs.writeFile(props.path, yamlContent);
-    // Get file stats for timestamps
-    const stats = await fs.stat(props.path);
     // Return the resource
     return this({
         ...props,
         schema: props.schema,
         content: yamlContent,
         yaml: yamlObject,
-        createdAt: stats.birthtimeMs,
-        updatedAt: stats.mtimeMs,
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
     });
 });
 /**

package/lib/alchemy.js

@@ -33,6 +33,17 @@ function _alchemy(...args) {
                 if (typeof value === "string") {
                     return indent + value;
                 }
+                else if (value === null) {
+                    return "null";
+                }
+                else if (value === undefined) {
+                    return "undefined";
+                }
+                else if (typeof value === "number" ||
+                    typeof value === "boolean" ||
+                    typeof value === "bigint") {
+                    return value.toString();
+                }
                 else if (value instanceof Promise) {
                     return resolve(await value);
                 }
@@ -55,7 +66,8 @@ function _alchemy(...args) {
                 }
                 else {
                     // TODO: support other types
-                    throw new Error(`Unsupported value type: ${JSON.stringify(value)}`);
+                    console.log(value);
+                    throw new Error(`Unsupported value type: ${value}`);
                 }
             }));
             // Construct the string template by joining template parts with interpolated values
@@ -104,7 +116,10 @@ _alchemy.secret = secret;
  *   apiKey: alchemy.secret(process.env.API_KEY)
  * });
  */
-function scope(id, options) {
+function scope(id, options
+// TODO: maybe we want to allow using _ = await alchemy.scope(import.meta)
+// | [meta: ImportMeta]
+) {
     const scope = new Scope({
         ...options,
         appName: options?.appName,

package/lib/apply.js

@@ -46,7 +46,7 @@ export async function apply(resource, props, options) {
             }), null, 2);
             if (oldProps === newProps && alwaysUpdate !== true) {
                 if (!quiet) {
-                    console.log(`Skip:    "${resource.FQN}" (no changes)`);
+                    // console.log(`Skip:    "${resource.FQN}" (no changes)`);
                 }
                 return state.output;
             }

package/lib/cloudflare/generate-asset-manifest.js

@@ -9,7 +9,7 @@ export async function generateAssetManifest(dir, fileOptions = [
         cacheControl: "max-age=0,no-cache,no-store,must-revalidate",
     },
     {
-        files: ["**/*.js", "**/*.css"],
+        files: ["**/*.js", "**/*.css", "**/*.png", "**/*.webp"],
         cacheControl: "max-age=31536000,public,immutable",
     },
 ]) {

package/lib/cloudflare/static-site-router.js

@@ -35,34 +35,44 @@ app.notFound(async (ctx) => {
     }
     // Fetch from KV
     {
-        const object = await env.ASSETS.getWithMetadata(filePath);
+        const object = await env.ASSETS.getWithMetadata(filePath, {
+            type: "arrayBuffer",
+        });
         if (object.value) {
             return await respond(200, filePath, object);
         }
     }
     {
         const guess = filePath + (filePath.endsWith("/") ? "" : "/") + "index.html";
-        const object = await env.ASSETS.getWithMetadata(guess);
+        const object = await env.ASSETS.getWithMetadata(guess, {
+            type: "arrayBuffer",
+        });
         if (object.value) {
             return await respond(200, guess, object);
         }
     }
     {
         const guess = filePath + ".html";
-        const object = await env.ASSETS.getWithMetadata(guess);
+        const object = await env.ASSETS.getWithMetadata(guess, {
+            type: "arrayBuffer",
+        });
         if (object.value) {
             return await respond(200, guess, object);
         }
     }
     // Handle error page
     if (env.ERROR_PAGE) {
-        const object = await env.ASSETS.getWithMetadata(env.ERROR_PAGE);
+        const object = await env.ASSETS.getWithMetadata(env.ERROR_PAGE, {
+            type: "arrayBuffer",
+        });
         if (object.value) {
             return await respond(404, env.ERROR_PAGE, object);
         }
     }
     else {
-        const object = await env.ASSETS.getWithMetadata(env.INDEX_PAGE);
+        const object = await env.ASSETS.getWithMetadata(env.INDEX_PAGE, {
+            type: "arrayBuffer",
+        });
         if (object.value) {
             return await respond(200, env.INDEX_PAGE, object);
         }
@@ -92,8 +102,7 @@ app.notFound(async (ctx) => {
             headers.set("content-type", object.metadata.contentType);
             headers.set("cache-control", object.metadata.cacheControl);
         }
-        // TODO: do we need base64 encoded here?
-        // const response = new Response(base64ToArrayBuffer(object.value), {
+        // Create response with the raw data directly
         const response = new Response(object.value, {
             status,
             headers,

package/lib/cloudflare/static-site.js

@@ -122,6 +122,9 @@ export const StaticSite = Resource("cloudflare::StaticSite", {
         }),
         generateAssetManifest(props.dir),
     ]);
+    console.log({
+        assetManifest,
+    });
     // Step 3: Upload assets to KV
     await uploadAssetManifest(api, kv.namespaceId, assetManifest);
     // Prepare the bindings for the worker

package/lib/cloudflare/upload-asset-manifest.js

@@ -34,8 +34,10 @@ export async function uploadAssetManifest(api, namespaceId, manifest) {
         // Create FormData for multipart upload
         const formData = new FormData();
         formData.append("metadata", JSON.stringify(metadata));
-        // Add file content as 'value'
-        const blob = new Blob([content]);
+        // Add file content as 'value' - Fix for binary file corruption
+        const blob = new Blob([new Uint8Array(content)], {
+            type: item.contentType,
+        });
         formData.append("value", blob);
         try {
             const response = await api.put(`/accounts/${api.accountId}/storage/kv/namespaces/${namespaceId}/values/${item.key}`, formData);

package/lib/fs/copy-file.d.ts

@@ -0,0 +1,54 @@
+import type { Context } from "../context";
+import { Resource } from "../resource";
+/**
+ * Properties for creating a CopyFile resource
+ */
+export interface CopyFileProps {
+    /**
+     * Source path of the file to copy
+     */
+    src: string;
+    /**
+     * Destination path where the file should be copied to
+     */
+    dest: string;
+    /**
+     * Whether to overwrite the destination file if it already exists
+     * @default true
+     */
+    overwrite?: boolean;
+}
+/**
+ * Output returned after CopyFile creation/update
+ */
+export interface CopyFile extends Resource<"fs::CopyFile">, CopyFileProps {
+    /**
+     * Time at which the object was created
+     */
+    createdAt: number;
+    /**
+     * Whether the file was successfully copied
+     */
+    copied: boolean;
+}
+/**
+ * CopyFile Resource
+ *
+ * Copies a file from a source location to a destination location.
+ *
+ * @example
+ * // Copy a file to a new location
+ * const copiedFile = await CopyFile("config-copy", {
+ *   src: "config.json",
+ *   dest: "backup/config.json"
+ * });
+ *
+ * @example
+ * // Copy a file without overwriting if destination exists
+ * const safeCopy = await CopyFile("safe-copy", {
+ *   src: "data.json",
+ *   dest: "backup/data.json",
+ *   overwrite: false
+ * });
+ */
+export declare const CopyFile: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<CopyFile>, id: string, props: CopyFileProps) => Promise<CopyFile>);

package/lib/fs/copy-file.js

@@ -0,0 +1,63 @@
+import fs from "node:fs";
+import { Resource } from "../resource";
+import { ignore } from "../util/ignore";
+/**
+ * CopyFile Resource
+ *
+ * Copies a file from a source location to a destination location.
+ *
+ * @example
+ * // Copy a file to a new location
+ * const copiedFile = await CopyFile("config-copy", {
+ *   src: "config.json",
+ *   dest: "backup/config.json"
+ * });
+ *
+ * @example
+ * // Copy a file without overwriting if destination exists
+ * const safeCopy = await CopyFile("safe-copy", {
+ *   src: "data.json",
+ *   dest: "backup/data.json",
+ *   overwrite: false
+ * });
+ */
+export const CopyFile = Resource("fs::CopyFile", async function (id, props) {
+    const { src, dest, overwrite = true } = props;
+    if (this.phase === "delete") {
+        // When deleting, remove the destination file
+        await ignore("ENOENT", async () => fs.promises.unlink(dest));
+        return this.destroy();
+    }
+    else {
+        try {
+            // Check if source file exists
+            await fs.promises.access(src, fs.constants.F_OK);
+            // If this is an update and the destination has changed, delete the old file
+            if (this.phase === "update" &&
+                this.output?.dest &&
+                this.output.dest !== dest) {
+                await ignore("ENOENT", async () => fs.promises.unlink(this.output.dest));
+            }
+            // Check if destination file exists
+            const destinationExists = await fs.promises
+                .access(dest, fs.constants.F_OK)
+                .then(() => true)
+                .catch(() => false);
+            // Copy file if destination doesn't exist or overwrite is true
+            if (!destinationExists || overwrite) {
+                await fs.promises.copyFile(src, dest);
+            }
+            return this({
+                src,
+                dest,
+                overwrite,
+                copied: true,
+                createdAt: Date.now(),
+            });
+        }
+        catch (error) {
+            console.error(`Error copying file from ${src} to ${dest}:`, error);
+            throw error;
+        }
+    }
+});

package/lib/fs/file.d.ts

@@ -79,6 +79,19 @@ export interface File extends Resource<"fs::File"> {
  *   path: "logs/app.log",
  *   content: "application log entry"
  * });
+ *
+ * @example
+ * // Update file content and path
+ * let file = await File("config.json", {
+ *   path: "config.json",
+ *   content: '{ "version": "1.0.0" }'
+ * });
+ *
+ * // Later, update the path and content (old file will be removed)
+ * file = await File("config.json", {
+ *   path: "config/config.json",
+ *   content: '{ "version": "1.0.1" }'
+ * });
  */
 export declare const File: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<File>, id: string, props: {
     path: string;

package/lib/fs/file.js

@@ -36,6 +36,19 @@ alchemy.files = async (...args) => {
  *   path: "logs/app.log",
  *   content: "application log entry"
  * });
+ *
+ * @example
+ * // Update file content and path
+ * let file = await File("config.json", {
+ *   path: "config.json",
+ *   content: '{ "version": "1.0.0" }'
+ * });
+ *
+ * // Later, update the path and content (old file will be removed)
+ * file = await File("config.json", {
+ *   path: "config/config.json",
+ *   content: '{ "version": "1.0.1" }'
+ * });
  */
 export const File = Resource("fs::File", async function (id, props) {
     const filePath = props?.path ?? id;
@@ -43,12 +56,18 @@ export const File = Resource("fs::File", async function (id, props) {
         await ignore("ENOENT", async () => fs.promises.unlink(filePath));
         return this.destroy();
     }
-    else {
-        await fs.promises.mkdir(path.dirname(filePath), {
-            recursive: true,
-        });
-        await fs.promises.writeFile(filePath, props.content);
+    else if (this.phase === "update" &&
+        this.output &&
+        this.output.path !== filePath) {
+        // If path has changed, delete the old file
+        console.log(`File: Path changed from ${this.output.path} to ${filePath}, removing old file`);
+        await ignore("ENOENT", async () => fs.promises.unlink(this.output.path));
     }
+    // Create directory and write file
+    await fs.promises.mkdir(path.dirname(filePath), {
+        recursive: true,
+    });
+    await fs.promises.writeFile(filePath, props.content);
     return this({
         path: filePath,
         content: props.content,

package/lib/fs/index.d.ts

@@ -1,8 +1,14 @@
+export * from "./copy-file";
 export * from "./file";
 export * from "./file-collection";
 export * from "./file-ref";
+export * from "./file-system-state-store";
 export * from "./folder";
+export * from "./static-astro-file";
+export * from "./static-css-file";
+export * from "./static-html-file";
 export * from "./static-json-file";
 export * from "./static-text-file";
 export * from "./static-typescript-file";
+export * from "./static-vue-file";
 export * from "./static-yaml-file";

package/lib/fs/index.js

@@ -1,8 +1,14 @@
+export * from "./copy-file";
 export * from "./file";
 export * from "./file-collection";
 export * from "./file-ref";
+export * from "./file-system-state-store";
 export * from "./folder";
+export * from "./static-astro-file";
+export * from "./static-css-file";
+export * from "./static-html-file";
 export * from "./static-json-file";
 export * from "./static-text-file";
 export * from "./static-typescript-file";
+export * from "./static-vue-file";
 export * from "./static-yaml-file";

package/lib/fs/static-astro-file.d.ts

@@ -0,0 +1,34 @@
+import { File } from "./file";
+export type StaticAstroFile = File;
+/**
+ * Creates a static Astro component file
+ *
+ * @example
+ * // Create an Astro component file with content
+ * const header = await StaticAstroFile("Header.astro",
+ *   `---
+ *   import Logo from '../components/Logo.astro';
+ *   const navItems = ['Home', 'About', 'Contact'];
+ *   ---
+ *
+ *   <header class="header">
+ *     <Logo />
+ *     <nav>
+ *       <ul>
+ *         {navItems.map(item => (
+ *           <li><a href={`/${item.toLowerCase()}`}>{item}</a></li>
+ *         ))}
+ *       </ul>
+ *     </nav>
+ *   </header>
+ *
+ *   <style>
+ *     .header {
+ *       display: flex;
+ *       justify-content: space-between;
+ *       padding: 1rem;
+ *     }
+ *   </style>`
+ * );
+ */
+export declare function StaticAstroFile(id: string, ...args: [content: string] | [path: string, content: string]): Promise<StaticAstroFile>;

package/lib/fs/static-astro-file.js

@@ -0,0 +1,39 @@
+import { File } from "./file";
+/**
+ * Creates a static Astro component file
+ *
+ * @example
+ * // Create an Astro component file with content
+ * const header = await StaticAstroFile("Header.astro",
+ *   `---
+ *   import Logo from '../components/Logo.astro';
+ *   const navItems = ['Home', 'About', 'Contact'];
+ *   ---
+ *
+ *   <header class="header">
+ *     <Logo />
+ *     <nav>
+ *       <ul>
+ *         {navItems.map(item => (
+ *           <li><a href={`/${item.toLowerCase()}`}>{item}</a></li>
+ *         ))}
+ *       </ul>
+ *     </nav>
+ *   </header>
+ *
+ *   <style>
+ *     .header {
+ *       display: flex;
+ *       justify-content: space-between;
+ *       padding: 1rem;
+ *     }
+ *   </style>`
+ * );
+ */
+export function StaticAstroFile(id, ...args) {
+    const [path, content] = args.length === 1 ? [id, args[0]] : args;
+    return File(id, {
+        path,
+        content,
+    });
+}