alchemy 0.6.0 → 0.7.0

package/lib/cloudflare/bindings.d.ts

@@ -9,22 +9,18 @@ import type { R2Bucket } from "./bucket";
 import type { DurableObjectNamespace } from "./durable-object-namespace";
 import type { KVNamespace } from "./kv-namespace";
 import type { Worker } from "./worker";
+import type { Workflow } from "./workflow";
 export type Bindings = {
     [bindingName: string]: Binding;
 };
 /**
  * L2 Binding Resources.
  */
-export type Binding = DurableObjectNamespace | KVNamespace | Worker | R2Bucket | Secret | string | Assets;
-export declare function isDurableObjectNamespace(binding: Binding): binding is DurableObjectNamespace;
-/**
- * Check if a binding is an Assets resource
- */
-export declare function isAssets(binding: Binding): binding is Assets;
+export type Binding = DurableObjectNamespace | KVNamespace | Worker | Workflow | R2Bucket | Secret | string | Assets;
 /**
  * Union type for all Worker binding types (API spec)
  */
-export type WorkerBindingSpec = WorkerBindingAI | WorkerBindingAnalyticsEngine | WorkerBindingAssets | WorkerBindingBrowserRendering | WorkerBindingD1 | WorkerBindingDispatchNamespace | WorkerBindingDurableObjectNamespace | WorkerBindingHyperdrive | WorkerBindingJson | WorkerBindingKVNamespace | WorkerBindingMTLSCertificate | WorkerBindingPlainText | WorkerBindingQueue | WorkerBindingR2Bucket | WorkerBindingSecretText | WorkerBindingService | WorkerBindingStaticContent | WorkerBindingTailConsumer | WorkerBindingVectorize | WorkerBindingVersionMetadata | WorkerBindingWasmModule;
+export type WorkerBindingSpec = WorkerBindingAI | WorkerBindingAnalyticsEngine | WorkerBindingAssets | WorkerBindingBrowserRendering | WorkerBindingD1 | WorkerBindingDispatchNamespace | WorkerBindingDurableObjectNamespace | WorkerBindingHyperdrive | WorkerBindingJson | WorkerBindingKVNamespace | WorkerBindingMTLSCertificate | WorkerBindingPlainText | WorkerBindingQueue | WorkerBindingR2Bucket | WorkerBindingSecretText | WorkerBindingService | WorkerBindingStaticContent | WorkerBindingTailConsumer | WorkerBindingVectorize | WorkerBindingVersionMetadata | WorkerBindingWasmModule | WorkerBindingWorkflow;
 /**
  * AI binding type
  */
@@ -264,3 +260,19 @@ export interface WorkerBindingStaticContent {
     /** Type identifier for Static Content binding */
     type: "static_content";
 }
+export interface WorkerBindingWorkflow {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Workflow binding */
+    type: "workflow";
+    /** Workflow name */
+    workflow_name: string;
+    /** Workflow class name */
+    class_name: string;
+    /**
+     * Workflow script name
+     *
+     * @default - the name of the script it is bound to
+     */
+    script_name?: string;
+}

package/lib/cloudflare/bindings.js

@@ -1,9 +0,0 @@
-export function isDurableObjectNamespace(binding) {
-    return (typeof binding === "object" && binding.type === "durable_object_namespace");
-}
-/**
- * Check if a binding is an Assets resource
- */
-export function isAssets(binding) {
-    return typeof binding === "object" && binding.type === "assets";
-}

package/lib/cloudflare/bound.d.ts

@@ -5,4 +5,5 @@ import type { R2Bucket as _R2Bucket } from "./bucket";
 import type { DurableObjectNamespace as _DurableObjectNamespace } from "./durable-object-namespace";
 import type { KVNamespace as _KVNamespace } from "./kv-namespace";
 import type { Worker as _Worker } from "./worker";
-export type Bound<T extends Binding> = T extends _DurableObjectNamespace ? DurableObjectNamespace : T extends _KVNamespace ? KVNamespace : T extends _Worker ? Worker : T extends _R2Bucket ? R2Bucket : T extends Secret ? string : T extends Assets ? Service : Service;
+import type { Workflow as _Workflow } from "./workflow";
+export type Bound<T extends Binding> = T extends _DurableObjectNamespace ? DurableObjectNamespace : T extends _KVNamespace ? KVNamespace : T extends _Worker ? Worker : T extends _R2Bucket ? R2Bucket : T extends Secret ? string : T extends Assets ? Service : T extends _Workflow<infer P> ? Workflow<P> : Service;

package/lib/cloudflare/index.d.ts

@@ -10,5 +10,6 @@ export * from "./kv-namespace";
 export * from "./permission-groups";
 export * from "./r2-rest-state-store";
 export * from "./worker";
+export { Workflow } from "./workflow";
 export * from "./wrangler.json";
 export * from "./zone";

package/lib/cloudflare/index.js

@@ -10,5 +10,6 @@ export * from "./kv-namespace";
 export * from "./permission-groups";
 export * from "./r2-rest-state-store";
 export * from "./worker";
+export { Workflow } from "./workflow";
 export * from "./wrangler.json";
 export * from "./zone";

package/lib/cloudflare/worker.js

@@ -2,13 +2,15 @@ import * as crypto from "crypto";
 import * as fs from "fs/promises";
 import { Bundle } from "../esbuild/bundle";
 import { Resource } from "../resource";
-import { isSecret } from "../secret";
 import { getContentType } from "../util/content-type";
 import { withExponentialBackoff } from "../util/retry";
 import { slugify } from "../util/slugify";
 import { createCloudflareApi, } from "./api";
-import { isAssets, isDurableObjectNamespace, } from "./bindings";
+import {} from "./assets";
+import {} from "./bindings";
+import {} from "./durable-object-namespace";
 import { isKVNamespace } from "./kv-namespace";
+import { upsertWorkflow } from "./workflow";
 /**
  * A Cloudflare Worker is a serverless function that can be deployed to the Cloudflare network.
  *
@@ -111,10 +113,16 @@ export const Worker = Resource("cloudflare::Worker", {
     const scriptContent = props.script ?? (await bundleWorkerScript(props));
     // Find any assets bindings
     const assetsBindings = [];
+    const workflowsBindings = [];
     if (props.bindings) {
         for (const [bindingName, binding] of Object.entries(props.bindings)) {
-            if (isAssets(binding)) {
-                assetsBindings.push({ name: bindingName, assets: binding });
+            if (typeof binding === "object") {
+                if (binding.type === "assets") {
+                    assetsBindings.push({ name: bindingName, assets: binding });
+                }
+                else if (binding.type === "workflow") {
+                    workflowsBindings.push(binding);
+                }
             }
         }
     }
@@ -129,8 +137,14 @@ export const Worker = Resource("cloudflare::Worker", {
     }
     // Prepare metadata with bindings
     const scriptMetadata = await prepareWorkerMetadata(this, oldBindings, props, assetUploadResult);
-    // Upload the worker script
     await putWorker(api, workerName, scriptContent, scriptMetadata);
+    for (const workflow of workflowsBindings) {
+        await upsertWorkflow(api, {
+            workflowName: workflow.workflowName,
+            className: workflow.className,
+            scriptName: workerName,
+        });
+    }
     // TODO: it is less than ideal that this can fail, resulting in state problem
     await this.set("bindings", props.bindings);
     // Handle worker URL if requested
@@ -273,33 +287,15 @@ async function prepareWorkerMetadata(ctx, oldBindings, props, assetUploadResult)
             });
         }
         else if (binding.type === "durable_object_namespace") {
-            const stableId = binding.id;
-            const className = binding.className;
             meta.bindings.push({
                 type: "durable_object_namespace",
                 name: bindingName,
-                class_name: className,
+                class_name: binding.className,
                 script_name: binding.scriptName,
                 environment: binding.environment,
                 namespace_id: binding.namespaceId,
             });
-            const oldBinding = Object.values(oldBindings ?? {})
-                ?.filter(isDurableObjectNamespace)
-                ?.find((b) => b.id === stableId);
-            if (!oldBinding) {
-                if (binding.sqlite) {
-                    meta.migrations.new_sqlite_classes.push(className);
-                }
-                else {
-                    meta.migrations.new_classes.push(className);
-                }
-            }
-            else if (oldBinding.className !== className) {
-                meta.migrations.renamed_classes.push({
-                    from: oldBinding.className,
-                    to: className,
-                });
-            }
+            configureClassMigration(binding, binding.id, binding.className);
         }
         else if (binding.type === "r2_bucket") {
             meta.bindings.push({
@@ -308,25 +304,58 @@ async function prepareWorkerMetadata(ctx, oldBindings, props, assetUploadResult)
                 bucket_name: binding.name,
             });
         }
-        else if (isAssets(binding)) {
+        else if (binding.type === "assets") {
             meta.bindings.push({
                 type: "assets",
                 name: bindingName,
             });
         }
-        else if (isSecret(binding)) {
+        else if (binding.type === "secret") {
             meta.bindings.push({
                 type: "secret_text",
                 name: bindingName,
                 text: binding.unencrypted,
             });
         }
+        else if (binding.type === "workflow") {
+            meta.bindings.push({
+                type: "workflow",
+                name: bindingName,
+                workflow_name: binding.workflowName,
+                class_name: binding.className,
+                // this should be set if the Workflow is in another script ...
+                // script_name: ??,
+            });
+            // it's unclear whether this is needed, but it works both ways
+            configureClassMigration(binding, binding.id, binding.className);
+        }
         else {
             // @ts-expect-error - we should never reach here
             throw new Error(`Unsupported binding type: ${binding.type}`);
         }
     }
+    function configureClassMigration(binding, stableId, className) {
+        const oldBinding = Object.values(oldBindings ?? {})
+            ?.filter((b) => typeof b === "object" &&
+            (b.type === "durable_object_namespace" || b.type === "workflow"))
+            ?.find((b) => b.id === stableId);
+        if (!oldBinding) {
+            if (binding.type === "durable_object_namespace" && binding.sqlite) {
+                meta.migrations.new_sqlite_classes.push(className);
+            }
+            else {
+                meta.migrations.new_classes.push(className);
+            }
+        }
+        else if (oldBinding.className !== className) {
+            meta.migrations.renamed_classes.push({
+                from: oldBinding.className,
+                to: className,
+            });
+        }
+    }
     // Convert env variables to plain_text bindings
+    // TODO(sam): remove Worker.env in favor of always bindings
     if (props.env) {
         for (const [key, value] of Object.entries(props.env)) {
             meta.bindings.push({

package/lib/cloudflare/workflow.d.ts

@@ -0,0 +1,46 @@
+import type { CloudflareApi } from "./api";
+export interface WorkflowProps {
+    /**
+     * Name of the workflow
+     *
+     * @maxLength 64
+     * @minLength 1
+     * @default - className if provided, otherwise id
+     */
+    workflowName?: string;
+    /**
+     * Name of the class that implements the workflow
+     *
+     * @maxLength 255
+     * @minLength 1
+     * @default - workflowName if provided, otherwise id
+     */
+    className?: string;
+}
+export declare class Workflow<PARAMS = unknown> {
+    readonly id: string;
+    readonly type: "workflow";
+    /**
+     * Phantom property to preserve workflow params at the type level.
+     *
+     * No value exists.
+     */
+    readonly _PARAMS: PARAMS;
+    readonly workflowName: string;
+    readonly className: string;
+    constructor(id: string, props?: WorkflowProps);
+}
+export interface WorkflowMetadata {
+    id: string;
+    class_name: string;
+    created_on: string;
+    modified_on: string;
+    name: string;
+    script_name: string;
+    triggered_on: string;
+    version_id: string;
+}
+export declare function upsertWorkflow(api: CloudflareApi, props: WorkflowProps & {
+    workflowName: string;
+    scriptName: string;
+}): Promise<WorkflowMetadata>;

package/lib/cloudflare/workflow.js

@@ -0,0 +1,29 @@
+import { handleApiError } from "./api-error";
+export class Workflow {
+    id;
+    type = "workflow";
+    /**
+     * Phantom property to preserve workflow params at the type level.
+     *
+     * No value exists.
+     */
+    _PARAMS = undefined;
+    workflowName;
+    className;
+    constructor(id, props = {}) {
+        this.id = id;
+        this.workflowName = props.workflowName ?? props.className ?? id;
+        this.className = props.className ?? this.workflowName;
+    }
+}
+export async function upsertWorkflow(api, props) {
+    const response = await api.put(`/accounts/${api.accountId}/workflows/${props.workflowName}`, {
+        class_name: props.className,
+        script_name: props.scriptName,
+    });
+    if (!response.ok) {
+        await handleApiError(response, "create", "workflow", props.workflowName);
+    }
+    const body = (await response.json());
+    return body.result;
+}

package/lib/internal/docs/providers.js

@@ -70,7 +70,7 @@ async function generateProviderDocs({ provider, outDir, parallel, }) {
       The ${provider} Service has the following resources:
       ${alchemy.files(files)}
 
-      A file is considered a "Resource" if it contains a const <ResourceName> = Resource(...) call or if it is a function that calls a Resource function, e.g. const TypeScriptFile = () => File(...).
+      A file is considered a "Resource" if it contains a const <ResourceName> = Resource(...) call or if it is a function that calls a Resource function, e.g. const TypeScriptFile = () => File(...), or it is the Workflow or DurableObject classes.
       A file is considered a "Client" if it exposes a wrapper around creating a SDK client or fetch.
       A file is considered a "Utility" if it contains utility functions that are not resources or clients.
       A file is considered a "Types" if it contains just type definitions and maybe helpers around working with those types.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "module": "./lib/index.js",
   "scripts": {

package/src/cloudflare/bindings.ts

@@ -9,6 +9,7 @@ import type { R2Bucket } from "./bucket";
 import type { DurableObjectNamespace } from "./durable-object-namespace";
 import type { KVNamespace } from "./kv-namespace";
 import type { Worker } from "./worker";
+import type { Workflow } from "./workflow";
 
 export type Bindings = {
   [bindingName: string]: Binding;
@@ -21,26 +22,12 @@ export type Binding =
   | DurableObjectNamespace
   | KVNamespace
   | Worker
+  | Workflow
   | R2Bucket
   | Secret
   | string
   | Assets;
 
-export function isDurableObjectNamespace(
-  binding: Binding
-): binding is DurableObjectNamespace {
-  return (
-    typeof binding === "object" && binding.type === "durable_object_namespace"
-  );
-}
-
-/**
- * Check if a binding is an Assets resource
- */
-export function isAssets(binding: Binding): binding is Assets {
-  return typeof binding === "object" && binding.type === "assets";
-}
-
 /**
  * Union type for all Worker binding types (API spec)
  */
@@ -65,7 +52,8 @@ export type WorkerBindingSpec =
   | WorkerBindingTailConsumer
   | WorkerBindingVectorize
   | WorkerBindingVersionMetadata
-  | WorkerBindingWasmModule;
+  | WorkerBindingWasmModule
+  | WorkerBindingWorkflow;
 
 /**
  * AI binding type
@@ -326,3 +314,20 @@ export interface WorkerBindingStaticContent {
   /** Type identifier for Static Content binding */
   type: "static_content";
 }
+
+export interface WorkerBindingWorkflow {
+  /** The name of the binding */
+  name: string;
+  /** Type identifier for Workflow binding */
+  type: "workflow";
+  /** Workflow name */
+  workflow_name: string;
+  /** Workflow class name */
+  class_name: string;
+  /**
+   * Workflow script name
+   *
+   * @default - the name of the script it is bound to
+   */
+  script_name?: string;
+}

package/src/cloudflare/bound.ts

@@ -5,6 +5,7 @@ import type { R2Bucket as _R2Bucket } from "./bucket";
 import type { DurableObjectNamespace as _DurableObjectNamespace } from "./durable-object-namespace";
 import type { KVNamespace as _KVNamespace } from "./kv-namespace";
 import type { Worker as _Worker } from "./worker";
+import type { Workflow as _Workflow } from "./workflow";
 
 export type Bound<T extends Binding> = T extends _DurableObjectNamespace
   ? DurableObjectNamespace
@@ -18,4 +19,6 @@ export type Bound<T extends Binding> = T extends _DurableObjectNamespace
           ? string
           : T extends Assets
             ? Service
-            : Service;
+            : T extends _Workflow<infer P>
+              ? Workflow<P>
+              : Service;

package/src/cloudflare/durable-object-namespace.ts

@@ -42,7 +42,7 @@ export class DurableObjectNamespace implements DurableObjectNamespaceInput {
 
   constructor(
     public readonly id: string,
-    input: DurableObjectNamespaceInput,
+    input: DurableObjectNamespaceInput
   ) {
     this.className = input.className;
     this.scriptName = input.scriptName;

package/src/cloudflare/index.ts

@@ -10,5 +10,6 @@ export * from "./kv-namespace";
 export * from "./permission-groups";
 export * from "./r2-rest-state-store";
 export * from "./worker";
+export { Workflow } from "./workflow";
 export * from "./wrangler.json";
 export * from "./zone";

package/src/cloudflare/worker.ts

@@ -3,27 +3,22 @@ import * as fs from "fs/promises";
 import type { Context } from "../context";
 import { Bundle, type BundleProps } from "../esbuild/bundle";
 import { Resource } from "../resource";
-import { isSecret } from "../secret";
 import { getContentType } from "../util/content-type";
 import { withExponentialBackoff } from "../util/retry";
 import { slugify } from "../util/slugify";
 import {
+  createCloudflareApi,
   type CloudflareApi,
   type CloudflareApiOptions,
-  createCloudflareApi,
 } from "./api";
-import type { Assets } from "./assets";
-import {
-  type Bindings,
-  type WorkerBindingSpec,
-  isAssets,
-  isDurableObjectNamespace,
-} from "./bindings";
+import { type Assets } from "./assets";
+import { type Bindings, type WorkerBindingSpec } from "./bindings";
 import type { Bound } from "./bound";
-import type { DurableObjectNamespace } from "./durable-object-namespace";
+import { type DurableObjectNamespace } from "./durable-object-namespace";
 import { isKVNamespace } from "./kv-namespace";
 import type { WorkerScriptMetadata } from "./worker-metadata";
 import type { SingleStepMigration } from "./worker-migration";
+import { upsertWorkflow, type Workflow } from "./workflow";
 
 /**
  * Properties for creating or updating a Worker
@@ -261,10 +256,16 @@ export const Worker = Resource(
 
     // Find any assets bindings
     const assetsBindings: { name: string; assets: Assets }[] = [];
+    const workflowsBindings: Workflow[] = [];
+
     if (props.bindings) {
       for (const [bindingName, binding] of Object.entries(props.bindings)) {
-        if (isAssets(binding)) {
-          assetsBindings.push({ name: bindingName, assets: binding });
+        if (typeof binding === "object") {
+          if (binding.type === "assets") {
+            assetsBindings.push({ name: bindingName, assets: binding });
+          } else if (binding.type === "workflow") {
+            workflowsBindings.push(binding);
+          }
         }
       }
     }
@@ -292,9 +293,16 @@ export const Worker = Resource(
       assetUploadResult
     );
 
-    // Upload the worker script
     await putWorker(api, workerName, scriptContent, scriptMetadata);
 
+    for (const workflow of workflowsBindings) {
+      await upsertWorkflow(api, {
+        workflowName: workflow.workflowName,
+        className: workflow.className,
+        scriptName: workerName,
+      });
+    }
+
     // TODO: it is less than ideal that this can fail, resulting in state problem
     await this.set("bindings", props.bindings);
 
@@ -532,60 +540,79 @@ async function prepareWorkerMetadata<B extends Bindings>(
         service: binding.id,
       });
     } else if (binding.type === "durable_object_namespace") {
-      const stableId = binding.id;
-      const className = binding.className;
-
       meta.bindings.push({
         type: "durable_object_namespace",
         name: bindingName,
-        class_name: className,
+        class_name: binding.className,
         script_name: binding.scriptName,
         environment: binding.environment,
         namespace_id: binding.namespaceId,
       });
-
-      const oldBinding: DurableObjectNamespace | undefined = Object.values(
-        oldBindings ?? {}
-      )
-        ?.filter(isDurableObjectNamespace)
-        ?.find((b) => b.id === stableId);
-
-      if (!oldBinding) {
-        if (binding.sqlite) {
-          meta.migrations!.new_sqlite_classes!.push(className);
-        } else {
-          meta.migrations!.new_classes!.push(className);
-        }
-      } else if (oldBinding.className !== className) {
-        meta.migrations!.renamed_classes!.push({
-          from: oldBinding.className,
-          to: className,
-        });
-      }
+      configureClassMigration(binding, binding.id, binding.className);
     } else if (binding.type === "r2_bucket") {
       meta.bindings.push({
         type: "r2_bucket",
         name: bindingName,
         bucket_name: binding.name,
       });
-    } else if (isAssets(binding)) {
+    } else if (binding.type === "assets") {
       meta.bindings.push({
         type: "assets",
         name: bindingName,
       });
-    } else if (isSecret(binding)) {
+    } else if (binding.type === "secret") {
       meta.bindings.push({
         type: "secret_text",
         name: bindingName,
         text: binding.unencrypted,
       });
+    } else if (binding.type === "workflow") {
+      meta.bindings.push({
+        type: "workflow",
+        name: bindingName,
+        workflow_name: binding.workflowName,
+        class_name: binding.className,
+        // this should be set if the Workflow is in another script ...
+        // script_name: ??,
+      });
+      // it's unclear whether this is needed, but it works both ways
+      configureClassMigration(binding, binding.id, binding.className);
     } else {
       // @ts-expect-error - we should never reach here
       throw new Error(`Unsupported binding type: ${binding.type}`);
     }
   }
 
+  function configureClassMigration(
+    binding: DurableObjectNamespace | Workflow,
+    stableId: string,
+    className: string
+  ) {
+    const oldBinding: DurableObjectNamespace | Workflow | undefined =
+      Object.values(oldBindings ?? {})
+        ?.filter(
+          (b) =>
+            typeof b === "object" &&
+            (b.type === "durable_object_namespace" || b.type === "workflow")
+        )
+        ?.find((b) => b.id === stableId);
+
+    if (!oldBinding) {
+      if (binding.type === "durable_object_namespace" && binding.sqlite) {
+        meta.migrations!.new_sqlite_classes!.push(className);
+      } else {
+        meta.migrations!.new_classes!.push(className);
+      }
+    } else if (oldBinding.className !== className) {
+      meta.migrations!.renamed_classes!.push({
+        from: oldBinding.className,
+        to: className,
+      });
+    }
+  }
+
   // Convert env variables to plain_text bindings
+  // TODO(sam): remove Worker.env in favor of always bindings
   if (props.env) {
     for (const [key, value] of Object.entries(props.env)) {
       meta.bindings.push({

package/src/cloudflare/workflow.ts

@@ -0,0 +1,79 @@
+import type { CloudflareApi } from "./api";
+import { handleApiError } from "./api-error";
+
+export interface WorkflowProps {
+  /**
+   * Name of the workflow
+   *
+   * @maxLength 64
+   * @minLength 1
+   * @default - className if provided, otherwise id
+   */
+  workflowName?: string;
+  /**
+   * Name of the class that implements the workflow
+   *
+   * @maxLength 255
+   * @minLength 1
+   * @default - workflowName if provided, otherwise id
+   */
+  className?: string;
+}
+
+export class Workflow<PARAMS = unknown> {
+  public readonly type: "workflow" = "workflow";
+  /**
+   * Phantom property to preserve workflow params at the type level.
+   *
+   * No value exists.
+   */
+  public readonly _PARAMS: PARAMS = undefined!;
+
+  public readonly workflowName: string;
+  public readonly className: string;
+
+  constructor(
+    public readonly id: string,
+    props: WorkflowProps = {}
+  ) {
+    this.workflowName = props.workflowName ?? props.className ?? id;
+    this.className = props.className ?? this.workflowName;
+  }
+}
+
+export interface WorkflowMetadata {
+  id: string; // uuid
+  class_name: string;
+  created_on: string; // date-time
+  modified_on: string; // date-time
+  name: string; // maxLength: 64, minLength: 1
+  script_name: string;
+  triggered_on: string; // date-time
+  version_id: string; // uuid
+}
+
+export async function upsertWorkflow(
+  api: CloudflareApi,
+  props: WorkflowProps & {
+    workflowName: string;
+    scriptName: string;
+  }
+) {
+  const response = await api.put(
+    `/accounts/${api.accountId}/workflows/${props.workflowName}`,
+    {
+      class_name: props.className,
+      script_name: props.scriptName,
+    }
+  );
+
+  if (!response.ok) {
+    await handleApiError(response, "create", "workflow", props.workflowName);
+  }
+
+  const body = (await response.json()) as {
+    result: WorkflowMetadata;
+  };
+
+  return body.result;
+}

package/src/internal/docs/providers.ts

@@ -145,7 +145,7 @@ async function generateProviderDocs({
       The ${provider} Service has the following resources:
       ${alchemy.files(files)}
 
-      A file is considered a "Resource" if it contains a const <ResourceName> = Resource(...) call or if it is a function that calls a Resource function, e.g. const TypeScriptFile = () => File(...).
+      A file is considered a "Resource" if it contains a const <ResourceName> = Resource(...) call or if it is a function that calls a Resource function, e.g. const TypeScriptFile = () => File(...), or it is the Workflow or DurableObject classes.
       A file is considered a "Client" if it exposes a wrapper around creating a SDK client or fetch.
       A file is considered a "Utility" if it contains utility functions that are not resources or clients.
       A file is considered a "Types" if it contains just type definitions and maybe helpers around working with those types.