effect-cf 0.33.0 → 0.35.0

package/dist/{Artifacts-DnHQA-Ax.d.mts → Artifacts-B3r3RuTB.d.mts}

@@ -1,13 +1,10 @@
-import { c as WorkerEnvironment, r as BindingValidationError, t as BindingNotFoundError } from "./Binding-xJJJPmiD.mjs";
+import { c as WorkerEnvironment, r as BindingValidationError, t as BindingNotFoundError } from "./Binding-DKcLrQCM.mjs";
 import { Context, Effect, Layer } from "effect";
 declare namespace Artifacts_d_exports {
   export { ArtifactsBinding, ArtifactsClient, ArtifactsCommit, ArtifactsCommitIdentity, ArtifactsCreateOptions, ArtifactsCreateRepoResult, ArtifactsCreateTokenResult, ArtifactsDefinition, ArtifactsErrorCode, ArtifactsForkOptions, ArtifactsImportParams, ArtifactsImportSource, ArtifactsImportTarget, ArtifactsImportTargetOptions, ArtifactsListOptions, ArtifactsLogOptions, ArtifactsLogResult, ArtifactsOperation, ArtifactsOperationError, ArtifactsRepoBinding, ArtifactsRepoClient, ArtifactsRepoInfo, ArtifactsRepoListEntry, ArtifactsRepoListResult, ArtifactsRepoStatus, ArtifactsService, ArtifactsTokenInfo, ArtifactsTokenListResult, ArtifactsTokenScope, ArtifactsTokenState, ArtifactsTree, Cursor, LayerOptions, RepoName, Tag, TagClass, artifactsErrorCodes, artifactsErrorNumericCodes, isArtifactsBinding, isArtifactsRepoBinding, layer, make, makeClient };
 }
-/** Artifacts operation represented by {@link ArtifactsOperationError}. */
 type ArtifactsOperation = "createClient" | "create" | "get" | "import" | "list" | "delete" | "createToken" | "listTokens" | "getToken" | "revokeToken" | "fork" | "info" | "log" | "readCommit" | "readTree" | "cli";
-/** Documented string error codes returned by Cloudflare Artifacts. */
 declare const artifactsErrorCodes: readonly ["ALREADY_EXISTS", "NOT_FOUND", "IMPORT_IN_PROGRESS", "FORK_IN_PROGRESS", "INVALID_INPUT", "INVALID_REPO_NAME", "INVALID_TTL", "INVALID_URL", "REMOTE_AUTH_REQUIRED", "UPSTREAM_UNAVAILABLE", "MEMORY_LIMIT", "INTERNAL_ERROR"];
-/** Documented numeric error codes returned by Cloudflare Artifacts. */
 declare const artifactsErrorNumericCodes: {
   readonly ALREADY_EXISTS: 10201;
   readonly NOT_FOUND: 10200;
@@ -22,47 +19,34 @@ declare const artifactsErrorNumericCodes: {
   readonly MEMORY_LIMIT: 10402;
   readonly INTERNAL_ERROR: 10400;
 };
-/** A documented Cloudflare Artifacts string error code. */
 type ArtifactsErrorCode = CloudflareArtifactsErrorCode;
 declare const ArtifactsOperationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "ArtifactsOperationError";
 } & Readonly<A>;
-/** Error raised when a Cloudflare Artifacts operation fails. */
 declare class ArtifactsOperationError extends ArtifactsOperationError_base<{
   readonly binding: string;
   readonly operation: ArtifactsOperation;
   readonly cause: unknown;
-  /** Cloudflare string error code, when retained by the runtime. */
   readonly code?: ArtifactsErrorCode | (string & {});
-  /** Cloudflare REST-compatible numeric error code, when retained by the runtime. */
   readonly numericCode?: number;
 }> {
   get message(): string;
 }
-/** Typed Cloudflare Artifacts binding definition. */
 interface ArtifactsDefinition {
-  /** Binding name from an `artifacts` entry in `wrangler.jsonc`. */
   readonly binding: string;
 }
-/** Repository name containing alphanumeric characters, dots, hyphens, or underscores. */
 type RepoName = string;
-/** Cursor used by repository list pagination. */
 type Cursor = string;
 /** Scope granted to a repository token. */
 type ArtifactsTokenScope = "read" | "write";
 /** Lifecycle state of a repository token. */
 type ArtifactsTokenState = "active" | "expired" | "revoked";
-/** Lifecycle state included with repositories returned by `list()`. */
 type ArtifactsRepoStatus = "ready" | "importing" | "forking";
-/** Stable repository metadata returned by Cloudflare Artifacts. */
 type ArtifactsRepoInfo = CloudflareArtifactsRepoInfo;
-/** Result of creating, importing, or forking a repository. */
 type ArtifactsCreateRepoResult = Readonly<CloudflareArtifactsCreateRepoResult>;
-/** Repository metadata returned by `list()`. */
 interface ArtifactsRepoListEntry extends ArtifactsRepoInfo {
   readonly status: ArtifactsRepoStatus;
 }
-/** Cursor-paginated repository list result. */
 interface ArtifactsRepoListResult {
   readonly repos: ReadonlyArray<ArtifactsRepoListEntry>;
   readonly total: number;
@@ -87,12 +71,9 @@ interface ArtifactsCommit {
   readonly author: ArtifactsCommitIdentity;
   readonly committer: ArtifactsCommitIdentity;
   readonly parents: ReadonlyArray<string>;
-  /** Unix timestamp in seconds. */
   readonly authoredAt: number;
-  /** Unix timestamp in seconds. */
   readonly committedAt: number;
 }
-/** Bare commit array returned by `log()`. */
 type ArtifactsLogResult = ReadonlyArray<ArtifactsCommit>;
 /**
  * Parsed Git tree returned by `readTree()`.
@@ -103,60 +84,44 @@ type ArtifactsLogResult = ReadonlyArray<ArtifactsCommit>;
 interface ArtifactsTree<Field = unknown> {
   readonly [field: string]: Field;
 }
-/** Options for `Artifacts.create()`. */
 interface ArtifactsCreateOptions {
-  /** Prevent pushes to the repository. */
   readonly readOnly?: boolean;
   readonly description?: string;
-  /** Initial default branch name. */
   readonly setDefaultBranch?: string;
 }
-/** Options for cursor-paginating `Artifacts.list()`. */
 interface ArtifactsListOptions {
-  /** Page size from 1 through 200. Defaults to 50. */
   readonly limit?: number;
-  /** Cursor returned by a previous list result. */
   readonly cursor?: Cursor;
 }
 /** External Git source used by `Artifacts.import()`. */
 interface ArtifactsImportSource {
   /** Full HTTPS URL of the Git repository. */
   readonly url: string;
-  /** Source branch. Defaults to the remote's default branch. */
   readonly branch?: string;
-  /** Shallow clone depth. */
   readonly depth?: number;
 }
-/** Options for the target of `Artifacts.import()`. */
 interface ArtifactsImportTargetOptions {
   readonly description?: string;
   readonly readOnly?: boolean;
 }
-/** Target repository used by `Artifacts.import()`. */
 interface ArtifactsImportTarget {
   readonly name: RepoName;
   readonly opts?: ArtifactsImportTargetOptions;
 }
-/** Parameters for `Artifacts.import()`. */
 interface ArtifactsImportParams {
   readonly source: ArtifactsImportSource;
   readonly target: ArtifactsImportTarget;
 }
-/** Options for `ArtifactsRepoClient.fork()`. */
 interface ArtifactsForkOptions {
   readonly description?: string;
   readonly readOnly?: boolean;
-  /** Only copy the default branch. Defaults to `true`. */
   readonly defaultBranchOnly?: boolean;
 }
-/** Options for `ArtifactsRepoClient.log()`. */
 interface ArtifactsLogOptions {
-  /** Branch, tag, or commit hash. */
   readonly ref?: string;
   readonly limit?: number;
   readonly offset?: number;
 }
-/** Runtime repository handle, including methods absent from current shipped Workers types. */
 interface ArtifactsRepoBinding extends Partial<ArtifactsRepoInfo> {
   /**
    * Read repository metadata.
@@ -180,7 +145,6 @@ interface ArtifactsRepoBinding extends Partial<ArtifactsRepoInfo> {
   readonly readCommit: (hash: string) => Promise<ArtifactsCommit>;
   readonly readTree: (hash: string) => Promise<ArtifactsTree>;
 }
-/** Cloudflare Artifacts namespace binding. */
 interface ArtifactsBinding {
   readonly create: (name: RepoName, options?: ArtifactsCreateOptions) => Promise<ArtifactsCreateRepoResult>;
   readonly get: (name: RepoName) => Promise<ArtifactsRepoBinding>;
@@ -188,14 +152,7 @@ interface ArtifactsBinding {
   readonly list: (options?: ArtifactsListOptions) => Promise<ArtifactsRepoListResult>;
   readonly delete: (name: RepoName) => Promise<boolean>;
 }
-/**
- * Effect wrapper around a repository handle returned by `Artifacts.get()`.
- *
- * The inherited metadata is the snapshot read while resolving the client.
- * Use `info()` to refresh it from the repository handle.
- */
 interface ArtifactsRepoClient extends ArtifactsRepoInfo {
-  /** Read and validate the repository's current metadata. */
   readonly info: () => Effect.Effect<ArtifactsRepoInfo, ArtifactsOperationError>;
   /**
    * Create a Git token for the repository.
@@ -212,7 +169,6 @@ interface ArtifactsRepoClient extends ArtifactsRepoInfo {
   readonly readTree: (hash: string) => Effect.Effect<ArtifactsTree, ArtifactsOperationError>;
   readonly raw: ArtifactsRepoBinding;
 }
-/** Effect wrapper around a Cloudflare Artifacts namespace binding. */
 interface ArtifactsClient {
   readonly create: (name: RepoName, options?: ArtifactsCreateOptions) => Effect.Effect<ArtifactsCreateRepoResult, ArtifactsOperationError>;
   readonly get: (name: RepoName) => Effect.Effect<ArtifactsRepoClient, ArtifactsOperationError>;
@@ -223,7 +179,6 @@ interface ArtifactsClient {
   readonly definition: ArtifactsDefinition;
 }
 declare const ArtifactsServiceTypeId: unique symbol;
-/** Nominal service marker for Artifacts services created with {@link make}. */
 interface ArtifactsService<Id extends string> {
   readonly [ArtifactsServiceTypeId]: {
     readonly id: Id;
@@ -236,9 +191,7 @@ interface TagClass<Self, Id extends string> extends Context.ServiceClass<Self, I
   readonly id: Id;
   readonly layer: (options: LayerOptions) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
 }
-/** Tests whether a value exposes the complete documented Artifacts repo handle API. */
 declare const isArtifactsRepoBinding: <Candidate>(value: Candidate) => value is Candidate & ArtifactsRepoBinding;
-/** Tests whether a value exposes the complete documented Artifacts namespace API. */
 declare const isArtifactsBinding: <Candidate>(value: Candidate) => value is Candidate & ArtifactsBinding;
 declare const makeClient: (definition: ArtifactsDefinition) => (artifacts: ArtifactsBinding) => ArtifactsClient;
 declare const layer: <Self>(tag: Context.Service<Self, ArtifactsClient>, definition: ArtifactsDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;

package/dist/{Artifacts-CSIk1Oml.mjs → Artifacts-CBxWGeZB.mjs}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
-import { t as causeMessage } from "./ErrorMessage-BM0K-Nik.mjs";
-import { r as layer$1 } from "./Binding-pfilNJmP.mjs";
+import { t as causeMessage } from "./ErrorMessage-Byx2OgNd.mjs";
+import { r as layer$1 } from "./Binding-C82jRhdr.mjs";
 import { Context, Data, Effect, Predicate, Schema } from "effect";
 //#region src/Artifacts.ts
 var Artifacts_exports = /* @__PURE__ */ __exportAll({
@@ -16,7 +16,6 @@ var Artifacts_exports = /* @__PURE__ */ __exportAll({
 });
 const expectedArtifactsBinding = "Artifacts binding with create(), get(), import(), list(), and delete()";
 const expectedArtifactsRepo = "Artifacts repo handle with createToken(), listTokens(), revokeToken(), fork(), log(), readCommit(), and readTree()";
-/** Documented string error codes returned by Cloudflare Artifacts. */
 const artifactsErrorCodes = [
 	"ALREADY_EXISTS",
 	"NOT_FOUND",
@@ -31,7 +30,6 @@ const artifactsErrorCodes = [
 	"MEMORY_LIMIT",
 	"INTERNAL_ERROR"
 ];
-/** Documented numeric error codes returned by Cloudflare Artifacts. */
 const artifactsErrorNumericCodes = {
 	ALREADY_EXISTS: 10201,
 	NOT_FOUND: 10200,
@@ -46,7 +44,6 @@ const artifactsErrorNumericCodes = {
 	MEMORY_LIMIT: 10402,
 	INTERNAL_ERROR: 10400
 };
-/** Error raised when a Cloudflare Artifacts operation fails. */
 var ArtifactsOperationError = class extends Data.TaggedError("ArtifactsOperationError") {
 	get message() {
 		const code = this.code === void 0 ? "" : ` (${this.code})`;
@@ -94,9 +91,7 @@ const readRepoInfo = (binding, repo) => {
 	if (hasFunction(repo, "info")) return tryArtifactsPromise(binding, "info", () => repo.info()).pipe(Effect.flatMap((info) => decodeRepoInfo(binding, info)), Effect.withSpan("Artifacts.info", spanOptions(binding, "info")));
 	return decodeRepoInfo(binding, repo).pipe(Effect.withSpan("Artifacts.info", spanOptions(binding, "info")));
 };
-/** Tests whether a value exposes the complete documented Artifacts repo handle API. */
 const isArtifactsRepoBinding = (value) => hasFunction(value, "createToken") && hasFunction(value, "listTokens") && hasFunction(value, "revokeToken") && hasFunction(value, "fork") && hasFunction(value, "log") && hasFunction(value, "readCommit") && hasFunction(value, "readTree");
-/** Tests whether a value exposes the complete documented Artifacts namespace API. */
 const isArtifactsBinding = (value) => hasFunction(value, "create") && hasFunction(value, "get") && hasFunction(value, "import") && hasFunction(value, "list") && hasFunction(value, "delete");
 const wrapRepo = (binding, repo, info) => ({
 	...info,

package/dist/{Binding-pfilNJmP.mjs → Binding-C82jRhdr.mjs}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
-import { a as WorkerEnvironment } from "./ErrorMessage-BM0K-Nik.mjs";
+import { a as WorkerEnvironment } from "./ErrorMessage-Byx2OgNd.mjs";
 import { Context, Data, Effect, Layer, Predicate } from "effect";
 //#region src/Binding.ts
 var Binding_exports = /* @__PURE__ */ __exportAll({
@@ -9,7 +9,6 @@ var Binding_exports = /* @__PURE__ */ __exportAll({
 	TypeId: () => TypeId,
 	layer: () => layer
 });
-/** Internal type id marker used by binding helper services. */
 const TypeId = "~effect-cf/Binding";
 /** Error raised when a configured binding does not exist on `env`. */
 var BindingNotFoundError = class extends Data.TaggedError("BindingNotFoundError") {};

package/dist/{Binding-xJJJPmiD.d.mts → Binding-DKcLrQCM.d.mts}

@@ -2,7 +2,6 @@ import { Config, ConfigProvider, Context, Effect, Layer, Predicate } from "effec
 declare namespace Environment_d_exports {
   export { WorkerConfig, WorkerEnv, WorkerEnvironment };
 }
-/** Cloudflare worker environment object (`env`). */
 type WorkerEnv = Cloudflare.Env;
 declare const WorkerEnvironment_base: Context.ServiceClass<WorkerEnvironment, "effect-cf/WorkerEnvironment", Cloudflare.Env>;
 /**
@@ -11,37 +10,8 @@ declare const WorkerEnvironment_base: Context.ServiceClass<WorkerEnvironment, "e
 declare class WorkerEnvironment extends WorkerEnvironment_base {}
 type ScalarConfigValue = string | number | boolean;
 type ScalarConfigKey = Extract<{ readonly [Key in keyof Cloudflare.Env]-?: NonNullable<Cloudflare.Env[Key]> extends ScalarConfigValue ? Key : never; }[keyof Cloudflare.Env], string>;
-/**
- * Effect `Config` helpers for scalar Cloudflare vars and secrets declared on
- * `Cloudflare.Env`.
- *
- * Users still author their app config explicitly with Effect `Config`:
- *
- * ```ts
- * import { Config, Effect } from "effect";
- * import { WorkerConfig } from "effect-cf";
- *
- * const AppConfig = Config.all({
- *   databaseUrl: WorkerConfig.redacted("DATABASE_URL"),
- *   port: WorkerConfig.integer("PORT").pipe(Config.withDefault(8787)),
- * });
- *
- * const program = Effect.gen(function* () {
- *   const config = yield* AppConfig;
- *   // ...
- * }).pipe(Effect.provide(WorkerConfig.providerLayer));
- * ```
- *
- * Keys are constrained to scalar `Cloudflare.Env` properties (`string`,
- * `number`, or `boolean`, including optional scalar properties). Binding
- * objects such as `KVNamespace`, `DurableObjectNamespace`, and service
- * bindings are intentionally excluded; keep using the package binding helpers
- * for those live resources.
- */
 declare namespace WorkerConfig {
-  /** Scalar env value types supported by the typed config key helpers. */
   type Scalar = ScalarConfigValue;
-  /** Scalar keys available on the current consumer's `Cloudflare.Env`. */
   type Key = ScalarConfigKey;
   /** Read a scalar Cloudflare var or secret as a string. */
   const string: <const Name extends Key>(name: Name) => Config.Config<string>;
@@ -53,7 +23,6 @@ declare namespace WorkerConfig {
   const integer: <const Name extends Key>(name: Name) => Config.Config<number>;
   /** Read a scalar Cloudflare var or secret as a boolean. */
   const boolean: <const Name extends Key>(name: Name) => Config.Config<boolean>;
-  /** Options for building a `ConfigProvider` from a Cloudflare worker `env` object. */
   interface ProviderOptions {
     /**
      * Keep empty-string env values as explicit `""` config values.
@@ -73,27 +42,19 @@ declare namespace WorkerConfig {
    * `{ preserveEmptyStrings: true }` to keep them as explicit values.
    */
   const providerFromEnv: (env: WorkerEnv, options?: ProviderOptions) => ConfigProvider.ConfigProvider;
-  /**
-   * Build a `ConfigProvider` from the current `WorkerEnvironment` with a custom
-   * conversion function.
-   */
   const providerWith: (makeProvider: (env: WorkerEnv) => ConfigProvider.ConfigProvider) => Effect.Effect<ConfigProvider.ConfigProvider, never, WorkerEnvironment>;
-  /** Build a `ConfigProvider` from the current `WorkerEnvironment`. */
   const provider: Effect.Effect<ConfigProvider.ConfigProvider, never, WorkerEnvironment>;
   /**
    * Replace the active Effect `ConfigProvider` with one backed by the current
    * Cloudflare worker `env` object.
    */
   const providerLayer: Layer.Layer<never, never, WorkerEnvironment>;
-  /** Build a `ConfigProvider` layer with a custom `env` conversion function. */
   const layerWith: (makeProvider: (env: WorkerEnv) => ConfigProvider.ConfigProvider) => Layer.Layer<never, never, WorkerEnvironment>;
 }
 declare namespace Binding_d_exports {
   export { BindingNotFoundError, BindingService, BindingValidationError, Service, TypeId, ValidationOptions, layer };
 }
-/** Internal type id marker used by binding helper services. */
 declare const TypeId: "~effect-cf/Binding";
-/** Internal type id marker used by binding helper services. */
 type TypeId = typeof TypeId;
 declare const BindingNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "BindingNotFoundError";
@@ -117,12 +78,6 @@ interface ValidationOptions {
   readonly expected?: string;
 }
 type BindingCandidate = Parameters<typeof Predicate.isUnknown>[0];
-/**
- * Creates a Context tag + layer for reading and validating a Cloudflare binding.
- *
- * The Context key is namespaced as `effect-cf/Binding/<id>`; `id` stays the
- * bare user-supplied identifier.
- */
 interface BindingService<Self, Id extends string, Service> extends Context.ServiceClass<Self, `effect-cf/Binding/${Id}`, Service> {
   readonly [TypeId]: TypeId;
   readonly id: Id;

package/dist/ComputerArtifacts.d.mts

@@ -1,4 +1,4 @@
-import { a as ArtifactsOperationError, c as ArtifactsTokenListResult, i as ArtifactsCreateTokenResult, n as ArtifactsCreateOptions, o as ArtifactsRepoInfo, r as ArtifactsCreateRepoResult, s as ArtifactsTokenInfo, t as ArtifactsBinding, u as RepoName } from "./Artifacts-DnHQA-Ax.mjs";
+import { a as ArtifactsOperationError, c as ArtifactsTokenListResult, i as ArtifactsCreateTokenResult, n as ArtifactsCreateOptions, o as ArtifactsRepoInfo, r as ArtifactsCreateRepoResult, s as ArtifactsTokenInfo, t as ArtifactsBinding, u as RepoName } from "./Artifacts-B3r3RuTB.mjs";
 import { Effect } from "effect";
 import { ArtifactClient, ArtifactImportOptions, ArtifactImportSource, ArtifactRepoSummary, ArtifactScope, ArtifactsCLIInput, ArtifactsCLIResult, RemoteAddFn } from "@cloudflare/computer/artifacts";
 //#region src/ComputerArtifacts.d.ts
@@ -18,7 +18,6 @@ type ComputerArtifactsCliInput = ArtifactsCLIInput;
 type ComputerArtifactsCliResult = Readonly<ArtifactsCLIResult>;
 /** Options used when wrapping a session-scoped Artifacts client. */
 interface ComputerArtifactsClientOptions {
-  /** Binding name attached to errors and tracing spans. Defaults to `ARTIFACTS`. */
   readonly binding?: string;
 }
 /**
@@ -43,7 +42,6 @@ interface ComputerArtifactsClient {
   readonly cli: (input: ComputerArtifactsCliInput) => Effect.Effect<ComputerArtifactsCliResult, ArtifactsOperationError>;
   readonly rawUnsafe: Effect.Effect<ArtifactClient>;
 }
-/** Wraps an already-created upstream session client. */
 declare const fromClient: (client: ArtifactClient, options?: ComputerArtifactsClientOptions) => ComputerArtifactsClient;
 /**
  * Creates an Effect-native session client directly from a Worker Artifacts

package/dist/ComputerArtifacts.mjs

@@ -1,4 +1,4 @@
-import { t as ArtifactsOperationError } from "./Artifacts-CSIk1Oml.mjs";
+import { t as ArtifactsOperationError } from "./Artifacts-CBxWGeZB.mjs";
 import { Effect, Predicate } from "effect";
 //#region src/ComputerArtifacts.ts
 const artifactsErrorDetails = (cause) => {
@@ -25,7 +25,6 @@ const spanOptions = (binding, sessionId, operation) => ({ attributes: {
 	sessionId,
 	operation
 } });
-/** Wraps an already-created upstream session client. */
 const fromClient = (client, options = {}) => {
 	const binding = options.binding ?? "ARTIFACTS";
 	const { sessionId } = client;

package/dist/ComputerWorkspace.d.mts

@@ -1,5 +1,5 @@
 import { ComputerArtifactsClient } from "./ComputerArtifacts.mjs";
-import { t as DurableObjectState } from "./DurableObjectState-BpRjz6-q.mjs";
+import { t as DurableObjectState } from "./DurableObjectState-DpYdNZgT.mjs";
 import { Context, Effect, Layer, Schema, Scope, Stream } from "effect";
 import { CommitView, GitClient, GitCloneOptions, GitCommitOptions, GitDiffOptions, GitFetchOptions, GitLogOptions, GitUpdateRefOptions } from "@cloudflare/computer/git";
 import { ExecSyncResult, RuntimeExecOptions, RuntimeGetOptions, RuntimeKillOptions, ShellValue, SkippedEntry, ThinkWorkspaceCompatibility, WorkspaceClient, WorkspaceRuntimeResult, WorkspaceRuntimeValue as WorkspaceRuntimeValue$1 } from "@cloudflare/computer";
@@ -56,6 +56,14 @@ declare const WorkspaceAssetsError_base: Schema.Class<WorkspaceAssetsError, Sche
 }>, import("effect/Cause").YieldableError>;
 /** Schema-serializable error for a workspace Assets operation. */
 declare class WorkspaceAssetsError extends WorkspaceAssetsError_base {}
+declare const WorkspaceAcquireError_base: Schema.Class<WorkspaceAcquireError, Schema.TaggedStruct<"WorkspaceAcquireError", {
+  readonly operation: Schema.String;
+  readonly message: Schema.String;
+  readonly code: Schema.optionalKey<Schema.String>;
+  readonly cause: Schema.optionalKey<Schema.Defect>;
+}>, import("effect/Cause").YieldableError>;
+/** Schema-serializable error while acquiring the Computer workspace client. */
+declare class WorkspaceAcquireError extends WorkspaceAcquireError_base {}
 type WorkspaceReadFileOptions = Omit<CloudflareReadFileOptions, "encoding">;
 type ReadTextFileOptions = WorkspaceReadFileOptions;
 type ListDirectoryOptions = CloudflareReaddirOptions;
@@ -79,7 +87,6 @@ interface WorkspaceReadFile {
     readonly encoding: "stream";
   }): Effect.Effect<ReadableStream<Uint8Array>, WorkspaceFsError>;
 }
-/** Complete Effect wrapper of `WorkspaceClient.fs`. */
 interface ComputerWorkspaceFilesystem {
   readonly readFile: WorkspaceReadFile;
   readonly stat: (path: string) => Effect.Effect<WorkspaceEntryStat, WorkspaceFsError>;
@@ -104,7 +111,6 @@ type WorkspaceGitUpdateRefOptions = GitUpdateRefOptions;
 type WorkspaceGitDiffOptions = GitDiffOptions;
 type WorkspaceGitCommitOptions = GitCommitOptions;
 interface WorkspaceGitLogOptions extends Omit<GitLogOptions, "depth"> {
-  /** Preferred upstream name for the history bound. */
   readonly depth?: number;
   /** Consumer-port compatibility alias for `depth`. */
   readonly maxCount?: number;
@@ -142,7 +148,6 @@ type CloudflareEncoding<Encoding extends WorkspaceExecEncoding> = Encoding exten
 type WorkspaceExecChunk<Encoding extends WorkspaceExecEncoding> = Encoding extends "utf8" ? string : Uint8Array;
 type WorkspaceExecOptions<Encoding extends WorkspaceExecEncoding = "utf8"> = Omit<RuntimeExecOptions, "encoding" | "timeoutMs"> & {
   readonly encoding?: Encoding;
-  /** Upstream runtime option name. */
   readonly timeoutMs?: number;
   /** Consumer-port compatibility alias for `timeoutMs`. */
   readonly timeoutMillis?: number;
@@ -211,7 +216,6 @@ interface WorkspaceExecCollect {
   (command: string, options?: WorkspaceExecOptions<"utf8">): Effect.Effect<WorkspaceExecResult<"utf8">, WorkspaceExecError>;
   (command: string, options: WorkspaceExecOptions<"binary">): Effect.Effect<WorkspaceExecResult<"binary">, WorkspaceExecError>;
 }
-/** Complete Effect wrapper of `WorkspaceClient.runtime`. */
 interface ComputerWorkspaceRuntime {
   readonly exec: WorkspaceExec;
   readonly execCollect: WorkspaceExecCollect;
@@ -221,14 +225,12 @@ interface ComputerWorkspaceRuntime {
     readonly backend?: string;
   }) => Effect.Effect<void, WorkspaceExecError>;
 }
-/** Effect wrapper over a configured local `Workspace.assets` client. */
 interface ComputerWorkspaceAssets {
   readonly share: (path: string, options: ShareOptions) => Effect.Effect<string, WorkspaceAssetsError>;
 }
 type EffectThinkMethod<Method> = Method extends ((...args: infer Args) => Promise<infer Success>) ? (...args: Args) => Effect.Effect<Success, WorkspaceFsError> : never;
 /** Effect wrapper of the optional Think compatibility surface. */
 type ComputerWorkspaceThink = { readonly [Name in keyof ThinkWorkspaceCompatibility]: EffectThinkMethod<ThinkWorkspaceCompatibility[Name]>; };
-/** Effect service over every client surface exposed by Cloudflare Computer. */
 interface ComputerWorkspaceService {
   readonly fs: ComputerWorkspaceFilesystem;
   readonly git: ComputerWorkspaceGit;
@@ -236,7 +238,6 @@ interface ComputerWorkspaceService {
   readonly artifacts: ComputerArtifactsClient;
   readonly assets: ComputerWorkspaceAssets | undefined;
   readonly think: ComputerWorkspaceThink | undefined;
-  /** Flat filesystem aliases retained for mechanical consumer migration. */
   readonly readFile: WorkspaceReadFile;
   readonly stat: ComputerWorkspaceFilesystem["stat"];
   readonly lstat: ComputerWorkspaceFilesystem["lstat"];
@@ -253,7 +254,6 @@ interface ComputerWorkspaceService {
   readonly removePath: ComputerWorkspaceFilesystem["rm"];
   readonly chmod: ComputerWorkspaceFilesystem["chmod"];
   readonly symlink: ComputerWorkspaceFilesystem["symlink"];
-  /** Flat runtime aliases retained for mechanical consumer migration. */
   readonly exec: WorkspaceExec;
   readonly execCollect: WorkspaceExecCollect;
   readonly getExec: WorkspaceGetExec;
@@ -267,13 +267,12 @@ interface ComputerWorkspaceService {
  */
 declare const fromWorkspaceClient: (client: WorkspaceClient) => ComputerWorkspaceService;
 declare const ComputerWorkspace_base: Context.ServiceClass<ComputerWorkspace, "effect-cf/ComputerWorkspace", ComputerWorkspaceService>;
-/** Effect service for the workspace owned by the enclosing Durable Object. */
 declare class ComputerWorkspace extends ComputerWorkspace_base {
   /**
    * Acquires the single workspace registered by `withComputerWorkspace` and
    * releases its RPC client when the layer scope closes.
    */
-  static readonly layer: Layer.Layer<ComputerWorkspace, never, DurableObjectState>;
+  static readonly layer: Layer.Layer<ComputerWorkspace, WorkspaceAcquireError, DurableObjectState>;
 }
 //#endregion
-export { ComputerWorkspace, ComputerWorkspaceAssets, ComputerWorkspaceFilesystem, ComputerWorkspaceGit, ComputerWorkspaceRuntime, ComputerWorkspaceService, type ComputerWorkspaceService as ComputerWorkspaceShape, ComputerWorkspaceThink, ListDirectoryOptions, ReadTextFileOptions, RemovePathOptions, WorkspaceAssetsError, WorkspaceDirectoryEntry, WorkspaceEntryStat, WorkspaceExec, WorkspaceExecChunk, WorkspaceExecCollect, WorkspaceExecEncoding, WorkspaceExecError, WorkspaceExecEvent, WorkspaceExecOptions, WorkspaceExecResult, WorkspaceExecRun, WorkspaceExecSignal, WorkspaceExecSkippedEntry, WorkspaceExecSyncResult, WorkspaceFindOptions, WorkspaceFoundEntry, WorkspaceFsError, WorkspaceGetExec, WorkspaceGetExecOptions, WorkspaceGitCheckoutOptions, WorkspaceGitCloneOptions, WorkspaceGitCommit, WorkspaceGitCommitOptions, WorkspaceGitDiffOptions, WorkspaceGitError, WorkspaceGitFetchOptions, WorkspaceGitFetchResult, WorkspaceGitLogOptions, WorkspaceGitPerson, WorkspaceGitUpdateRefOptions, WorkspaceGrepMatch, WorkspaceGrepOptions, WorkspaceMkdirOptions, WorkspaceReadEncoding, WorkspaceReadFile, WorkspaceReadFileOptions, WorkspaceRuntimeValue, WorkspaceWriteFileContent, WorkspaceWriteFileOptions, fromWorkspaceClient };
+export { ComputerWorkspace, ComputerWorkspaceAssets, ComputerWorkspaceFilesystem, ComputerWorkspaceGit, ComputerWorkspaceRuntime, ComputerWorkspaceService, type ComputerWorkspaceService as ComputerWorkspaceShape, ComputerWorkspaceThink, ListDirectoryOptions, ReadTextFileOptions, RemovePathOptions, WorkspaceAcquireError, WorkspaceAssetsError, WorkspaceDirectoryEntry, WorkspaceEntryStat, WorkspaceExec, WorkspaceExecChunk, WorkspaceExecCollect, WorkspaceExecEncoding, WorkspaceExecError, WorkspaceExecEvent, WorkspaceExecOptions, WorkspaceExecResult, WorkspaceExecRun, WorkspaceExecSignal, WorkspaceExecSkippedEntry, WorkspaceExecSyncResult, WorkspaceFindOptions, WorkspaceFoundEntry, WorkspaceFsError, WorkspaceGetExec, WorkspaceGetExecOptions, WorkspaceGitCheckoutOptions, WorkspaceGitCloneOptions, WorkspaceGitCommit, WorkspaceGitCommitOptions, WorkspaceGitDiffOptions, WorkspaceGitError, WorkspaceGitFetchOptions, WorkspaceGitFetchResult, WorkspaceGitLogOptions, WorkspaceGitPerson, WorkspaceGitUpdateRefOptions, WorkspaceGrepMatch, WorkspaceGrepOptions, WorkspaceMkdirOptions, WorkspaceReadEncoding, WorkspaceReadFile, WorkspaceReadFileOptions, WorkspaceRuntimeValue, WorkspaceWriteFileContent, WorkspaceWriteFileOptions, fromWorkspaceClient };

package/dist/ComputerWorkspace.mjs

@@ -1,4 +1,4 @@
-import { t as DurableObjectState } from "./DurableObjectState-CVLLse69.mjs";
+import { t as DurableObjectState } from "./DurableObjectState-DcqElJ4e.mjs";
 import { fromClient } from "./ComputerArtifacts.mjs";
 import { t as lookup } from "./ComputerWorkspaceHostRegistry-CY5Fv4Ng.mjs";
 import { Context, Effect, Layer, Predicate, Schema, Stream } from "effect";
@@ -37,6 +37,13 @@ var WorkspaceAssetsError = class extends Schema.TaggedError()("WorkspaceAssetsEr
 	code: Schema.optionalKey(Schema.String),
 	cause: Schema.optionalKey(Schema.Defect({ includeStack: true }))
 }) {};
+/** Schema-serializable error while acquiring the Computer workspace client. */
+var WorkspaceAcquireError = class extends Schema.TaggedError()("WorkspaceAcquireError", {
+	operation: Schema.String,
+	message: Schema.String,
+	code: Schema.optionalKey(Schema.String),
+	cause: Schema.optionalKey(Schema.Defect({ includeStack: true }))
+}) {};
 const errorMessage = (cause) => cause instanceof Error ? cause.message : String(cause);
 const errorCode = (cause) => {
 	if (Predicate.hasProperty(cause, "code") && Predicate.isString(cause.code)) return cause.code;
@@ -72,6 +79,16 @@ const execError = (operation, cause) => {
 	if (code !== void 0) properties.code = code;
 	return WorkspaceExecError.make(properties);
 };
+const acquireError = (operation, cause) => {
+	const properties = {
+		operation,
+		message: errorMessage(cause),
+		cause
+	};
+	const code = errorCode(cause);
+	if (code !== void 0) properties.code = code;
+	return WorkspaceAcquireError.make(properties);
+};
 const assetsError = (operation, path, cause) => {
 	const properties = {
 		operation,
@@ -404,7 +421,6 @@ const wrapRun = (handle) => {
 		kill
 	};
 };
-const releaseRun = (handle) => Effect.sync(() => handle[Symbol.dispose]());
 const makeRuntime = (client) => {
 	const execImplementation = Effect.fn("ComputerWorkspace.runtime.exec", { attributes: {
 		family: "runtime",
@@ -415,14 +431,14 @@ const makeRuntime = (client) => {
 			backend: options?.backend,
 			runId: options?.id
 		});
-		const handle = yield* Effect.acquireRelease(Effect.tryPromise({
+		const handle = yield* Effect.acquireDisposable(Effect.tryPromise({
 			try: () => {
 				if (Predicate.isString(source)) return client.runtime.exec(source, runtimeExecOptions(options));
 				const values = optionsOrValue === void 0 ? remainingValues : [optionsOrValue, ...remainingValues];
 				return client.runtime.exec(source, ...values);
 			},
 			catch: (cause) => execError("exec", cause)
-		}), releaseRun);
+		}));
 		return wrapRun(handle);
 	});
 	const exec = execImplementation;
@@ -434,10 +450,10 @@ const makeRuntime = (client) => {
 			backend: options?.backend,
 			runId: id
 		});
-		const handle = yield* Effect.acquireRelease(Effect.tryPromise({
+		const handle = yield* Effect.acquireDisposable(Effect.tryPromise({
 			try: () => client.runtime.getExec(id, runtimeGetOptions(options)),
 			catch: (cause) => execError("getExec", cause)
-		}), releaseRun);
+		}));
 		return wrapRun(handle);
 	});
 	const killExec = Effect.fn("ComputerWorkspace.runtime.killExec", { attributes: {
@@ -559,7 +575,6 @@ const fromWorkspaceClient = (client) => {
 		disposeExec: runtime.disposeExec
 	};
 };
-/** Effect service for the workspace owned by the enclosing Durable Object. */
 var ComputerWorkspace = class ComputerWorkspace extends Context.Service()("effect-cf/ComputerWorkspace") {
 	/**
 	* Acquires the single workspace registered by `withComputerWorkspace` and
@@ -568,10 +583,16 @@ var ComputerWorkspace = class ComputerWorkspace extends Context.Service()("effec
 	static layer = Layer.effect(ComputerWorkspace, Effect.gen(function* () {
 		const host = lookup((yield* DurableObjectState).raw);
 		if (host === void 0) return yield* Effect.die("ComputerWorkspace.layer requires a Durable Object class built with withComputerWorkspace");
-		const computer = yield* Effect.promise(() => import("@cloudflare/computer"));
-		const client = yield* Effect.acquireRelease(Effect.promise(() => computer.getWorkspace(host)), (workspace) => Effect.sync(() => workspace[Symbol.dispose]()));
+		const computer = yield* Effect.tryPromise({
+			try: () => import("@cloudflare/computer"),
+			catch: (cause) => acquireError("import", cause)
+		});
+		const client = yield* Effect.acquireDisposable(Effect.tryPromise({
+			try: () => computer.getWorkspace(host),
+			catch: (cause) => acquireError("getWorkspace", cause)
+		}));
 		return ComputerWorkspace.of(fromWorkspaceClient(client));
 	}));
 };
 //#endregion
-export { ComputerWorkspace, WorkspaceAssetsError, WorkspaceExecError, WorkspaceFsError, WorkspaceGitError, fromWorkspaceClient };
+export { ComputerWorkspace, WorkspaceAcquireError, WorkspaceAssetsError, WorkspaceExecError, WorkspaceFsError, WorkspaceGitError, fromWorkspaceClient };

package/dist/ComputerWorkspaceHost.d.mts

@@ -1,9 +1,8 @@
-import { t as ArtifactsBinding } from "./Artifacts-DnHQA-Ax.mjs";
+import { t as ArtifactsBinding } from "./Artifacts-B3r3RuTB.mjs";
 import { GitClientFactory } from "@cloudflare/computer/git";
 import { DurableObjectStorageLike, SyncRetryIntent, SyncRetryOptions, SyncRetryScheduler, WithWorkspaceCtor, WorkspaceAttributeValue, WorkspaceAttributes, WorkspaceObserver, WorkspaceOptions, WorkspaceRegisteredBackend, WorkspaceRetryPendingSyncResult, WorkspaceServiceProxy, WorkspaceSpan } from "@cloudflare/computer";
 import { ShellModuleGroup, WorkerShellBackendOptions, WorkerShellLoader, WorkspaceEgressPolicy } from "@cloudflare/computer/backends/worker-shell";
 //#region src/ComputerWorkspaceHost.d.ts
-/** The value of a `worker_loaders` binding. */
 type DynamicWorkerLoader = WorkerShellLoader;
 /** Default author and committer identity for workspace Git operations. */
 interface ComputerWorkspaceGitIdentity {
@@ -25,20 +24,13 @@ interface ComputerWorkspaceArtifactsOptions {
  */
 interface ComputerWorkspaceShellOptions extends Omit<WorkerShellBackendOptions, "source" | "loader" | "workspace" | "ctx" | "egress"> {
   readonly loader: DynamicWorkerLoader;
-  /** Durable Object namespace binding that points back to the wrapped class. */
   readonly hostBinding: string;
-  /** Current Durable Object id, normally `ctx.id.toString()`. */
   readonly hostId: string;
-  /** Current Durable Object execution context, normally `ctx`. */
   readonly executionContext: unknown;
-  /** Dynamic Worker egress policy. Defaults to `{ mode: "none" }`. */
   readonly egress?: WorkspaceEgressPolicy;
 }
-/** Configuration accepted by {@link withComputerWorkspace}. */
 interface ComputerWorkspaceHostConfig {
-  /** Native SQLite-backed Durable Object storage (`ctx.storage`). */
   readonly storage: globalThis.DurableObjectStorage | DurableObjectStorageLike;
-  /** Stable workspace id used by mounts and as the default Artifacts session. */
   readonly sessionId?: string;
   readonly gitIdentity?: ComputerWorkspaceGitIdentity;
   /** Override the default `createGitClient()` factory. */