alchemy 0.51.3 → 0.52.0

package/src/cloudflare/dispatch-namespace.ts

@@ -1,6 +1,5 @@
 import type { Context } from "../context.ts";
 import { Resource, ResourceKind } from "../resource.ts";
-import { bind } from "../runtime/bind.ts";
 import { logger } from "../util/logger.ts";
 import { CloudflareApiError, handleApiError } from "./api-error.ts";
 import {
@@ -37,14 +36,14 @@ export interface DispatchNamespaceProps extends CloudflareApiOptions {
 
 export function isDispatchNamespace(
   resource: Resource,
-): resource is DispatchNamespaceResource {
+): resource is DispatchNamespace {
   return resource[ResourceKind] === "cloudflare::DispatchNamespace";
 }
 
 /**
  * Output returned after Dispatch Namespace creation/update
  */
-export interface DispatchNamespaceResource
+export interface DispatchNamespace
   extends Resource<"cloudflare::DispatchNamespace">,
     Omit<DispatchNamespaceProps, "delete"> {
   type: "dispatch_namespace";
@@ -74,10 +73,6 @@ export interface DispatchNamespaceResource
   modifiedAt: number;
 }
 
-export type DispatchNamespace = DispatchNamespaceResource & {
-  get(name: string): Fetcher;
-};
-
 /**
  * A Cloudflare Dispatch Namespace enables routing worker requests to different scripts based on patterns.
  *
@@ -107,27 +102,13 @@ export type DispatchNamespace = DispatchNamespaceResource & {
  *   delete: false
  * });
  */
-
-export async function DispatchNamespace(
-  name: string,
-  props: DispatchNamespaceProps = {},
-): Promise<DispatchNamespace> {
-  const dispatchNamespace = await _DispatchNamespace(name, props);
-  const binding = await bind(dispatchNamespace);
-  return {
-    ...dispatchNamespace,
-    // Add runtime methods that dispatch namespaces have
-    get: binding.get,
-  };
-}
-
-const _DispatchNamespace = Resource(
+export const DispatchNamespace = Resource(
   "cloudflare::DispatchNamespace",
   async function (
-    this: Context<DispatchNamespaceResource>,
+    this: Context<DispatchNamespace>,
     id: string,
-    props: DispatchNamespaceProps,
-  ): Promise<DispatchNamespaceResource> {
+    props: DispatchNamespaceProps = {},
+  ): Promise<DispatchNamespace> {
     // Create Cloudflare API client with automatic account discovery
     const api = await createCloudflareApi(props);
 

package/src/cloudflare/event-source.ts

@@ -1,10 +1,10 @@
 import type { QueueConsumerSettings } from "./queue-consumer.ts";
-import type { QueueResource } from "./queue.ts";
+import type { Queue } from "./queue.ts";
 
 /**
  * Base interface for event sources that can be bound to a Worker
  */
-export type EventSource = QueueEventSource | QueueResource;
+export type EventSource = QueueEventSource | Queue;
 
 /**
  * Configuration for a Queue as an event source for a Worker
@@ -13,7 +13,7 @@ export interface QueueEventSource {
   /**
    * The queue to consume messages from
    */
-  readonly queue: QueueResource;
+  readonly queue: Queue;
 
   /**
    * Optional settings for configuring how the Worker consumes the queue

package/src/cloudflare/hyperdrive.ts

@@ -1,11 +1,9 @@
 import type { Context } from "../context.ts";
 import { Resource } from "../resource.ts";
-import { tryGetBinding } from "../runtime/bind.ts";
 import type { Secret } from "../secret.ts";
 import { logger } from "../util/logger.ts";
 import { handleApiError } from "./api-error.ts";
 import { createCloudflareApi, type CloudflareApiOptions } from "./api.ts";
-import type { Bound } from "./bound.ts";
 
 /**
  * Origin configuration for a PostgreSQL or MySQL database connection
@@ -156,7 +154,7 @@ export interface HyperdriveProps extends CloudflareApiOptions {
  * Output returned after Cloudflare Hyperdrive creation/update.
  * IMPORTANT: The interface name MUST match the exported resource name.
  */
-export interface HyperdriveResource
+export interface Hyperdrive
   extends Resource<"cloudflare::Hyperdrive">,
     Omit<HyperdriveProps, "origin"> {
   /**
@@ -181,8 +179,6 @@ export interface HyperdriveResource
   type: "hyperdrive";
 }
 
-export type Hyperdrive = HyperdriveResource & Bound<HyperdriveResource>;
-
 /**
  * Represents a Cloudflare Hyperdrive configuration.
  *
@@ -261,24 +257,13 @@ export type Hyperdrive = HyperdriveResource & Bound<HyperdriveResource>;
  *   }
  * });
  */
-export async function Hyperdrive(
-  name: string,
-  props: HyperdriveProps,
-): Promise<Hyperdrive> {
-  const resource = await HyperdriveResource(name, props);
-  return {
-    ...resource,
-    ...tryGetBinding(resource),
-  } as Hyperdrive;
-}
-
-const HyperdriveResource = Resource(
+export const Hyperdrive = Resource(
   "cloudflare::Hyperdrive",
   async function (
-    this: Context<HyperdriveResource>,
+    this: Context<Hyperdrive>,
     id: string,
     props: HyperdriveProps,
-  ): Promise<HyperdriveResource> {
+  ): Promise<Hyperdrive> {
     const api = await createCloudflareApi(props);
     const configsPath = `/accounts/${api.accountId}/hyperdrive/configs`;
 

package/src/cloudflare/index.ts

@@ -55,6 +55,7 @@ export * from "./vectorize-metadata-index.ts";
 export * from "./version-metadata.ts";
 export * from "./vite.ts";
 export * from "./website.ts";
+export * from "./worker-ref.ts";
 export * from "./worker-stub.ts";
 export * from "./worker-subdomain.ts";
 export * from "./worker.ts";

package/src/cloudflare/kv-namespace.ts

@@ -1,6 +1,5 @@
 import type { Context } from "../context.ts";
 import { Resource, ResourceKind } from "../resource.ts";
-import { bind } from "../runtime/bind.ts";
 import { logger } from "../util/logger.ts";
 import { withExponentialBackoff } from "../util/retry.ts";
 import { handleApiError } from "./api-error.ts";
@@ -9,7 +8,6 @@ import {
   type CloudflareApi,
   type CloudflareApiOptions,
 } from "./api.ts";
-import type { Bound } from "./bound.ts";
 
 /**
  * Properties for creating or updating a KV Namespace
@@ -84,16 +82,14 @@ export interface KVPair {
   metadata?: any;
 }
 
-export function isKVNamespace(
-  resource: Resource,
-): resource is KVNamespaceResource {
+export function isKVNamespace(resource: Resource): resource is KVNamespace {
   return resource[ResourceKind] === "cloudflare::KVNamespace";
 }
 
 /**
  * Output returned after KV Namespace creation/update
  */
-export interface KVNamespaceResource
+export interface KVNamespace
   extends Resource<"cloudflare::KVNamespace">,
     Omit<KVNamespaceProps, "delete"> {
   type: "kv_namespace";
@@ -113,8 +109,6 @@ export interface KVNamespaceResource
   modifiedAt: number;
 }
 
-export type KVNamespace = KVNamespaceResource & Bound<KVNamespaceResource>;
-
 /**
  * A Cloudflare KV Namespace is a key-value store that can be used to store data for your application.
  *
@@ -169,30 +163,13 @@ export type KVNamespace = KVNamespaceResource & Bound<KVNamespaceResource>;
  *   delete: false
  * });
  */
-
-export async function KVNamespace(
-  name: string,
-  props: KVNamespaceProps = {},
-): Promise<KVNamespace> {
-  const kv = await _KVNamespace(name, props);
-  const binding = await bind(kv);
-  return {
-    ...kv,
-    delete: binding.delete,
-    get: binding.get,
-    getWithMetadata: binding.getWithMetadata,
-    list: binding.list,
-    put: binding.put,
-  };
-}
-
-const _KVNamespace = Resource(
+export const KVNamespace = Resource(
   "cloudflare::KVNamespace",
   async function (
-    this: Context<KVNamespaceResource>,
+    this: Context<KVNamespace>,
     id: string,
     props: KVNamespaceProps,
-  ): Promise<KVNamespaceResource> {
+  ): Promise<KVNamespace> {
     // Create Cloudflare API client with automatic account discovery
     const api = await createCloudflareApi(props);
 

package/src/cloudflare/pipeline.ts

@@ -1,6 +1,5 @@
 import type { Context } from "../context.ts";
 import { Resource, ResourceKind } from "../resource.ts";
-import { bind } from "../runtime/bind.ts";
 import type { Secret } from "../secret.ts";
 import { logger } from "../util/logger.ts";
 import { CloudflareApiError, handleApiError } from "./api-error.ts";
@@ -9,7 +8,6 @@ import {
   type CloudflareApi,
   type CloudflareApiOptions,
 } from "./api.ts";
-import type { Bound } from "./bound.ts";
 
 /**
  * Settings for compression of pipeline output
@@ -229,10 +227,14 @@ export interface PipelineRecord {
   [key: string]: any;
 }
 
+export function isPipeline(resource: Resource): resource is Pipeline {
+  return resource[ResourceKind] === "cloudflare::Pipeline";
+}
+
 /**
  * Output returned after Pipeline creation/update
  */
-export interface PipelineResource<_T extends PipelineRecord = PipelineRecord>
+export interface Pipeline<_T extends PipelineRecord = PipelineRecord>
   extends Resource<"cloudflare::Pipeline">,
     PipelineProps {
   /**
@@ -261,13 +263,6 @@ export interface PipelineResource<_T extends PipelineRecord = PipelineRecord>
   version: number;
 }
 
-export function isPipeline(resource: Resource): resource is PipelineResource {
-  return resource[ResourceKind] === "cloudflare::Pipeline";
-}
-
-export type Pipeline<T extends PipelineRecord = PipelineRecord> =
-  PipelineResource<T> & Bound<PipelineResource<T>>;
-
 /**
  * Creates and manages Cloudflare Pipelines.
  *
@@ -334,24 +329,10 @@ export type Pipeline<T extends PipelineRecord = PipelineRecord> =
  *
  * @see https://developers.cloudflare.com/pipelines/
  */
-export async function Pipeline<T extends PipelineRecord = PipelineRecord>(
-  name: string,
-  props: PipelineProps,
-): Promise<Pipeline<T>> {
-  const pipeline = await PipelineResource(name, props);
-  const binding = await bind(pipeline, {
-    bindThis: false,
-  });
-  return {
-    ...pipeline,
-    send: binding.send,
-  };
-}
-
-const PipelineResource = Resource("cloudflare::Pipeline", async function <
+export const Pipeline = Resource("cloudflare::Pipeline", async function <
   T extends PipelineRecord = PipelineRecord,
->(this: Context<PipelineResource<T>>, id: string, props: PipelineProps): Promise<
-  PipelineResource<T>
+>(this: Context<Pipeline<T>>, id: string, props: PipelineProps): Promise<
+  Pipeline<T>
 > {
   const api = await createCloudflareApi(props);
   const pipelineName = props.name ?? id;

package/src/cloudflare/queue-consumer.ts

@@ -7,7 +7,7 @@ import {
   type CloudflareApi,
   type CloudflareApiOptions,
 } from "./api.ts";
-import type { Queue, QueueResource } from "./queue.ts";
+import type { Queue } from "./queue.ts";
 
 /**
  * Settings for configuring a Queue Consumer
@@ -55,9 +55,9 @@ export interface QueueConsumerSettings {
  */
 export interface QueueConsumerProps extends CloudflareApiOptions {
   /**
-   * The {@link QueueResource} or Queue ID to consume
+   * The {@link Queue} or Queue ID to consume
    */
-  queue: string | QueueResource;
+  queue: string | Queue;
 
   /**
    * Name of the worker script that will consume the queue

package/src/cloudflare/queue.ts

@@ -1,13 +1,11 @@
 import type { Context } from "../context.ts";
 import { Resource, ResourceKind } from "../resource.ts";
-import { bind } from "../runtime/bind.ts";
 import { CloudflareApiError, handleApiError } from "./api-error.ts";
 import {
   createCloudflareApi,
   type CloudflareApi,
   type CloudflareApiOptions,
 } from "./api.ts";
-import type { Bound } from "./bound.ts";
 
 /**
  * Settings for a Cloudflare Queue
@@ -95,7 +93,7 @@ export function isQueue(eventSource: any): eventSource is Queue {
 /**
  * Output returned after Cloudflare Queue creation/update
  */
-export interface QueueResource<Body = unknown>
+export interface Queue<Body = unknown>
   extends Resource<"cloudflare::Queue">,
     QueueProps {
   /**
@@ -131,9 +129,6 @@ export interface QueueResource<Body = unknown>
   Batch: MessageBatch<Body>;
 }
 
-export type Queue<Body = unknown> = QueueResource<Body> &
-  Bound<QueueResource<Body>>;
-
 /**
  * Creates and manages Cloudflare Queues.
  *
@@ -213,23 +208,10 @@ export type Queue<Body = unknown> = QueueResource<Body> &
  *
  * @see https://developers.cloudflare.com/queues/
  */
-export async function Queue<Body = unknown>(
-  name: string,
-  props: QueueProps = {},
-): Promise<Queue<Body>> {
-  const queue = await QueueResource<Body>(name, props);
-  const binding = await bind(queue);
-  return {
-    ...queue,
-    send: binding.send,
-    sendBatch: binding.sendBatch,
-  } as Queue<Body>;
-}
-
-const QueueResource = Resource("cloudflare::Queue", async function <
+export const Queue = Resource("cloudflare::Queue", async function <
   T = unknown,
->(this: Context<QueueResource<T>>, id: string, props: QueueProps = {}): Promise<
-  QueueResource<T>
+>(this: Context<Queue<T>>, id: string, props: QueueProps = {}): Promise<
+  Queue<T>
 > {
   const api = await createCloudflareApi(props);
   const queueName = props.name ?? id;

package/src/cloudflare/vectorize-index.ts

@@ -1,6 +1,5 @@
 import type { Context } from "../context.ts";
 import { Resource, ResourceKind } from "../resource.ts";
-import { bind } from "../runtime/bind.ts";
 import { logger } from "../util/logger.ts";
 import { CloudflareApiError, handleApiError } from "./api-error.ts";
 import {
@@ -8,7 +7,6 @@ import {
   type CloudflareApi,
   type CloudflareApiOptions,
 } from "./api.ts";
-import type { Bound } from "./bound.ts";
 
 /**
  * Properties for creating or updating a Vectorize Index
@@ -53,14 +51,14 @@ export interface VectorizeIndexProps extends CloudflareApiOptions {
 
 export function isVectorizeIndex(
   resource: Resource,
-): resource is VectorizeIndexResource {
+): resource is VectorizeIndex {
   return resource[ResourceKind] === "cloudflare::VectorizeIndex";
 }
 
 /**
  * Output returned after Vectorize Index creation/update
  */
-export interface VectorizeIndexResource
+export interface VectorizeIndex
   extends Resource<"cloudflare::VectorizeIndex">,
     VectorizeIndexProps {
   type: "vectorize";
@@ -76,9 +74,6 @@ export interface VectorizeIndexResource
   createdAt?: number;
 }
 
-export type VectorizeIndex = VectorizeIndexResource &
-  Bound<VectorizeIndexResource>;
-
 /**
  * Creates and manages Cloudflare Vectorize Indexes.
  *
@@ -118,30 +113,13 @@ export type VectorizeIndex = VectorizeIndexResource &
  *
  * @see https://developers.cloudflare.com/vectorize/
  */
-export async function VectorizeIndex(
-  name: string,
-  props: VectorizeIndexProps,
-): Promise<VectorizeIndex> {
-  const index = await _VectorizeIndex(name, props);
-  const binding = await bind(index);
-  return {
-    ...index,
-    describe: binding.describe,
-    query: binding.query,
-    insert: binding.insert,
-    upsert: binding.upsert,
-    deleteByIds: binding.deleteByIds,
-    getByIds: binding.getByIds,
-  };
-}
-
-const _VectorizeIndex = Resource(
+export const VectorizeIndex = Resource(
   "cloudflare::VectorizeIndex",
   async function (
-    this: Context<VectorizeIndexResource>,
+    this: Context<VectorizeIndex>,
     id: string,
     props: VectorizeIndexProps,
-  ): Promise<VectorizeIndexResource> {
+  ): Promise<VectorizeIndex> {
     const api = await createCloudflareApi(props);
     const indexName = props.name || id;
 

package/src/cloudflare/vectorize-metadata-index.ts

@@ -7,7 +7,7 @@ import {
   type CloudflareApi,
   type CloudflareApiOptions,
 } from "./api.ts";
-import type { VectorizeIndexResource } from "./vectorize-index.ts";
+import type { VectorizeIndex } from "./vectorize-index.ts";
 
 /**
  * Properties for creating or deleting a Vectorize Metadata Index
@@ -16,7 +16,7 @@ export interface VectorizeMetadataIndexProps extends CloudflareApiOptions {
   /**
    * Parent Vectorize Index
    */
-  index: VectorizeIndexResource;
+  index: VectorizeIndex;
 
   /**
    * Name of the property in the metadata to create an index for

package/src/cloudflare/worker-ref.ts

@@ -0,0 +1,51 @@
+import type { WorkerBindingService } from "./bindings.ts";
+
+/**
+ * Represents a reference to a Cloudflare Worker service.
+ *
+ * @template RPC - The type of the worker's RPC entrypoint, defaults to Rpc.WorkerEntrypointBranded.
+ *
+ * This interface extends all properties of WorkerBindingService except for "name".
+ * It also includes an optional __rpc__ property for type branding.
+ */
+export type WorkerRef<
+  RPC extends Rpc.WorkerEntrypointBranded = Rpc.WorkerEntrypointBranded,
+> = Omit<WorkerBindingService, "name"> & {
+  /**
+   * Optional type branding for the worker's RPC entrypoint.
+   */
+  __rpc__?: RPC;
+};
+
+/**
+ * Creates a reference to a Cloudflare Worker service.
+ *
+ * @example
+ * // Create a reference to a Cloudflare Worker service:
+ * const ref = WorkerRef({
+ *   service: "my-worker",
+ *   environment: "production",
+ *   namespace: "main"
+ * });
+ *
+ * // Optionally, you can specify only the service:
+ * const ref2 = WorkerRef({ service: "my-worker" });
+ *
+ * // You can also specify the RPC type for stronger typing:
+ * interface MyWorkerRPC extends Rpc.WorkerEntrypointBranded {
+ *   myMethod(arg: string): Promise<number>;
+ * }
+ * const typedRef = WorkerRef<MyWorkerRPC>({ service: "my-worker" });
+ */
+export function WorkerRef<
+  RPC extends Rpc.WorkerEntrypointBranded = Rpc.WorkerEntrypointBranded,
+>(options?: {
+  service: string;
+  environment?: string;
+  namespace?: string;
+}): WorkerRef<RPC> {
+  return {
+    ...options,
+    type: "service",
+  } as WorkerRef<RPC>;
+}