alchemy 2.0.0-beta.3 → 2.0.0-beta.test-export-fix-3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "2.0.0-beta.3",
+  "version": "2.0.0-beta.test-export-fix-3",
   "homepage": "https://alchemy.run",
   "license": "Apache-2.0",
   "author": "Sam Goodwin <sam@alchemy.run>",
@@ -10,8 +10,7 @@
     "directory": "alchemy"
   },
   "bin": {
-    "alchemy": "bin/alchemy-effect.sh",
-    "alchemy-effect": "bin/alchemy-effect.sh"
+    "alchemy": "bin/alchemy.sh"
   },
   "files": [
     "bin",
@@ -30,172 +29,172 @@
   },
   "exports": {
     ".": {
-      "types": "./src/index.d.ts",
       "bun": "./src/index.ts",
       "worker": "./src/index.ts",
-      "import": "./lib/index.js"
+      "import": "./lib/index.js",
+      "types": "./src/index.d.ts"
     },
     "./*": {
-      "types": "./src/*.d.ts",
       "bun": "./src/*.ts",
+      "import": "./lib/*.js",
       "worker": "./src/*.ts",
-      "import": "./lib/*.js"
+      "types": "./src/*.d.ts"
     },
     "./Agent": {
-      "types": "./src/Agent/index.d.ts",
       "bun": "./src/Agent/index.ts",
       "worker": "./src/Agent/index.ts",
-      "import": "./lib/Agent/index.js"
+      "import": "./lib/Agent/index.js",
+      "types": "./src/Agent/index.d.ts"
     },
     "./AWS": {
-      "types": "./src/AWS/index.d.ts",
       "bun": "./src/AWS/index.ts",
       "worker": "./src/AWS/index.ts",
-      "import": "./lib/AWS/index.js"
+      "import": "./lib/AWS/index.js",
+      "types": "./src/AWS/index.d.ts"
     },
     "./AWS/*": {
-      "types": "./src/AWS/*/index.d.ts",
       "bun": "./src/AWS/*/index.ts",
       "worker": "./src/AWS/*/index.ts",
-      "import": "./lib/AWS/*/index.js"
+      "import": "./lib/AWS/*/index.js",
+      "types": "./src/AWS/*/index.d.ts"
     },
     "./AWS/Credentials": {
-      "types": "./src/AWS/Credentials/index.d.ts",
       "bun": "./src/AWS/Credentials/index.ts",
       "worker": "./src/AWS/Credentials/index.ts",
-      "import": "./lib/AWS/Credentials/index.js"
+      "import": "./lib/AWS/Credentials/index.js",
+      "types": "./src/AWS/Credentials/index.d.ts"
     },
     "./AWS/Endpoint": {
-      "types": "./src/AWS/Endpoint/index.d.ts",
       "bun": "./src/AWS/Endpoint/index.ts",
       "worker": "./src/AWS/Endpoint/index.ts",
-      "import": "./lib/AWS/Endpoint/index.js"
+      "import": "./lib/AWS/Endpoint/index.js",
+      "types": "./src/AWS/Endpoint/index.d.ts"
     },
     "./AWS/Region": {
-      "types": "./src/AWS/Region/index.d.ts",
       "bun": "./src/AWS/Region/index.ts",
       "worker": "./src/AWS/Region/index.ts",
-      "import": "./lib/AWS/Region/index.js"
+      "import": "./lib/AWS/Region/index.js",
+      "types": "./src/AWS/Region/index.d.ts"
     },
     "./AWS/Profile": {
-      "types": "./src/AWS/Profile/index.d.ts",
       "bun": "./src/AWS/Profile/index.ts",
       "worker": "./src/AWS/Profile/index.ts",
-      "import": "./lib/AWS/Profile/index.js"
+      "import": "./lib/AWS/Profile/index.js",
+      "types": "./src/AWS/Profile/index.d.ts"
     },
     "./AWS/Lambda/*": {
-      "types": "./src/AWS/Lambda/*.d.ts",
       "bun": "./src/AWS/Lambda/*.ts",
       "worker": "./src/AWS/Lambda/*.ts",
-      "import": "./lib/AWS/Lambda/*.js"
+      "import": "./lib/AWS/Lambda/*.js",
+      "types": "./src/AWS/Lambda/*.d.ts"
     },
     "./Build": {
-      "types": "./src/Build/index.d.ts",
       "bun": "./src/Build/index.ts",
       "worker": "./src/Build/index.ts",
-      "import": "./lib/Build/index.js"
+      "import": "./lib/Build/index.js",
+      "types": "./src/Build/index.d.ts"
     },
     "./Construct": {
-      "types": "./src/Construct/index.d.ts",
       "bun": "./src/Construct/index.ts",
       "worker": "./src/Construct/index.ts",
-      "import": "./lib/Construct/index.js"
+      "import": "./lib/Construct/index.js",
+      "types": "./src/Construct/index.d.ts"
     },
     "./Bundle": {
-      "types": "./src/Bundle/index.d.ts",
       "bun": "./src/Bundle/index.ts",
       "worker": "./src/Bundle/index.ts",
-      "import": "./lib/Bundle/index.js"
+      "import": "./lib/Bundle/index.js",
+      "types": "./src/Bundle/index.d.ts"
     },
     "./ContentType": {
-      "types": "./src/ContentType.d.ts",
       "bun": "./src/ContentType.ts",
       "worker": "./src/ContentType.ts",
-      "import": "./lib/ContentType.js"
+      "import": "./lib/ContentType.js",
+      "types": "./src/ContentType.d.ts"
     },
     "./Cloudflare": {
-      "types": "./src/Cloudflare/index.d.ts",
       "bun": "./src/Cloudflare/index.ts",
       "worker": "./src/Cloudflare/index.ts",
-      "import": "./lib/Cloudflare/index.js"
+      "import": "./lib/Cloudflare/index.js",
+      "types": "./src/Cloudflare/index.d.ts"
     },
     "./Cloudflare/Live": {
-      "types": "./src/Cloudflare/Live.d.ts",
       "bun": "./src/Cloudflare/Live.ts",
       "worker": "./src/Cloudflare/Live.ts",
-      "import": "./lib/Cloudflare/Live.js"
+      "import": "./lib/Cloudflare/Live.js",
+      "types": "./src/Cloudflare/Live.d.ts"
     },
     "./Cloudflare/*": {
-      "types": "./src/Cloudflare/*/index.d.ts",
       "bun": "./src/Cloudflare/*/index.ts",
       "worker": "./src/Cloudflare/*/index.ts",
-      "import": "./lib/Cloudflare/*/index.js"
+      "import": "./lib/Cloudflare/*/index.js",
+      "types": "./src/Cloudflare/*/index.d.ts"
     },
     "./GitHub": {
-      "types": "./src/GitHub/index.d.ts",
       "bun": "./src/GitHub/index.ts",
       "worker": "./src/GitHub/index.ts",
-      "import": "./lib/GitHub/index.js"
+      "import": "./lib/GitHub/index.js",
+      "types": "./src/GitHub/index.d.ts"
     },
     "./Endpoint": {
-      "types": "./src/Endpoint/index.d.ts",
       "bun": "./src/Endpoint/index.ts",
       "worker": "./src/Endpoint/index.ts",
-      "import": "./lib/Endpoint/index.js"
+      "import": "./lib/Endpoint/index.js",
+      "types": "./src/Endpoint/index.d.ts"
     },
     "./Kubernetes": {
-      "types": "./src/Kubernetes/index.d.ts",
       "bun": "./src/Kubernetes/index.ts",
       "worker": "./src/Kubernetes/index.ts",
-      "import": "./lib/Kubernetes/index.js"
+      "import": "./lib/Kubernetes/index.js",
+      "types": "./src/Kubernetes/index.d.ts"
     },
     "./Output": {
-      "types": "./src/Output.d.ts",
       "bun": "./src/Output.ts",
       "worker": "./src/Output.ts",
-      "import": "./lib/Output.js"
+      "import": "./lib/Output.js",
+      "types": "./src/Output.d.ts"
     },
     "./Process": {
-      "types": "./src/Process/index.d.ts",
       "bun": "./src/Process/index.ts",
       "worker": "./src/Process/index.ts",
-      "import": "./lib/Process/index.js"
+      "import": "./lib/Process/index.js",
+      "types": "./src/Process/index.d.ts"
     },
     "./SQLite": {
-      "types": "./src/SQLite/index.d.ts",
       "bun": "./src/SQLite/index.ts",
       "worker": "./src/SQLite/index.ts",
-      "import": "./lib/SQLite/index.js"
+      "import": "./lib/SQLite/index.js",
+      "types": "./src/SQLite/index.d.ts"
     },
     "./TUI": {
-      "types": "./src/TUI/index.d.ts",
       "bun": "./src/TUI/index.ts",
       "worker": "./src/TUI/index.ts",
-      "import": "./lib/TUI/index.js"
+      "import": "./lib/TUI/index.js",
+      "types": "./src/TUI/index.d.ts"
     },
     "./Server": {
-      "types": "./src/Server/index.d.ts",
       "bun": "./src/Server/index.ts",
       "worker": "./src/Server/index.ts",
-      "import": "./lib/Server/index.js"
+      "import": "./lib/Server/index.js",
+      "types": "./src/Server/index.d.ts"
     },
     "./State": {
-      "types": "./src/State/index.d.ts",
       "bun": "./src/State/index.ts",
       "worker": "./src/State/index.ts",
-      "import": "./lib/State/index.js"
+      "import": "./lib/State/index.js",
+      "types": "./src/State/index.d.ts"
     },
     "./Test/Bun": {
-      "types": "./src/Test/Bun.d.ts",
       "bun": "./src/Test/Bun.ts",
       "worker": "./src/Test/Bun.ts",
-      "import": "./lib/Test/Bun.js"
+      "import": "./lib/Test/Bun.js",
+      "types": "./src/Test/Bun.d.ts"
     },
     "./Util": {
-      "types": "./src/Util/index.d.ts",
       "bun": "./src/Util/index.ts",
       "worker": "./src/Util/index.ts",
-      "import": "./lib/Util/index.js"
+      "import": "./lib/Util/index.js",
+      "types": "./src/Util/index.d.ts"
     }
   },
   "publishConfig": {
@@ -208,8 +207,8 @@
     "@aws-sdk/credential-providers": "^3.0.0",
     "@distilled.cloud/aws": "^0.10.0",
     "@distilled.cloud/cloudflare": "^0.10.0",
-    "@distilled.cloud/cloudflare-rolldown-plugin": "0.2.0",
-    "@distilled.cloud/cloudflare-vite-plugin": "0.1.0",
+    "@distilled.cloud/cloudflare-rolldown-plugin": "0.3.0",
+    "@distilled.cloud/cloudflare-vite-plugin": "0.2.0",
     "@distilled.cloud/core": "^0.10.0",
     "@effect/vitest": "4.0.0-beta.48",
     "@libsql/client": "^0.17.0",

package/src/AWS/AGENTS.md

@@ -51,7 +51,7 @@ Bindings are:
 
 - one file per operation
 - `Binding.Service` + `Binding.Policy`
-- usually named `alchemy-effect/src/AWS/<Service>/<Operation>.ts`
+- usually named `alchemy/src/AWS/<Service>/<Operation>.ts`
 
 ### 2. Resource
 
@@ -73,10 +73,10 @@ Use an event source when the service can push records/events into a runtime.
 
 This always has two layers:
 
-1. Service-level abstraction in `alchemy-effect/src/AWS/<Service>/...`
+1. Service-level abstraction in `alchemy/src/AWS/<Service>/...`
 2. Runtime-specific implementation in places like:
-   - `alchemy-effect/src/AWS/Lambda/...`
-   - `alchemy-effect/src/Process/...`
+   - `alchemy/src/AWS/Lambda/...`
+   - `alchemy/src/Process/...`
 
 Examples:
 
@@ -248,8 +248,8 @@ Example:
 
 After each binding/resource implementation, update:
 
-1. `alchemy-effect/src/AWS/<Service>/index.ts`
-2. `alchemy-effect/src/AWS/Providers.ts`
+1. `alchemy/src/AWS/<Service>/index.ts`
+2. `alchemy/src/AWS/Providers.ts`
 
 If registration is missing, audit should flag it.
 
@@ -257,7 +257,7 @@ If registration is missing, audit should flag it.
 
 Every implemented binding should have a corresponding `describe("<BindingName>")` block in:
 
-- `alchemy-effect/test/AWS/<Service>/Bindings.test.ts`
+- `alchemy/test/AWS/<Service>/Bindings.test.ts`
 
 Examples:
 
@@ -282,7 +282,7 @@ Deterministic rule:
 
 Use a real Lambda fixture in:
 
-- `alchemy-effect/test/AWS/<Service>/handler.ts`
+- `alchemy/test/AWS/<Service>/handler.ts`
 
 Pattern:
 
@@ -412,8 +412,8 @@ Required shape:
 - `Table` keeps stream state in its attributes, but does not accept `streamSpecification` as a plain input prop
 - stream enablement is requested through the table binding contract
 - the public helper is `streams(table).process(...)`
-- the service-level abstraction lives in `alchemy-effect/src/AWS/DynamoDB/Stream.ts`
-- the Lambda runtime implementation lives in `alchemy-effect/src/AWS/Lambda/TableEventSource.ts`
+- the service-level abstraction lives in `alchemy/src/AWS/DynamoDB/Stream.ts`
+- the Lambda runtime implementation lives in `alchemy/src/AWS/Lambda/TableEventSource.ts`
 
 Why this pattern exists:
 

package/src/AWS/Assets.ts

@@ -152,7 +152,7 @@ export const assetsLayer = Layer.effect(
     if (Option.isNone(maybeBucket)) {
       return yield* Effect.fail(
         new Error(
-          "Assets bucket not found. Run 'alchemy-effect bootstrap' to create it.",
+          "Assets bucket not found. Run 'alchemy bootstrap' to create it.",
         ),
       );
     }

package/src/AWS/Credentials.ts

@@ -7,7 +7,6 @@ import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Option from "effect/Option";
 import { Profile } from "./Profile.ts";
-
 import { StageConfig } from "./StageConfig.ts";
 
 export { Credentials } from "@distilled.cloud/aws/Credentials";

package/src/AWS/DynamoDB/Table.ts

@@ -115,7 +115,9 @@ export interface Table extends Resource<
  * @section Creating Tables
  * @example Basic Table
  * ```typescript
- * const table = yield* Table("UsersTable", {
+ * import * as DynamoDB from "alchemy/AWS/DynamoDB";
+ *
+ * const table = yield* DynamoDB.Table("UsersTable", {
  *   partitionKey: "pk",
  *   attributes: {
  *     pk: "S",
@@ -125,7 +127,7 @@ export interface Table extends Resource<
  *
  * @example Table with Sort Key and TTL
  * ```typescript
- * const table = yield* Table("SessionsTable", {
+ * const table = yield* DynamoDB.Table("SessionsTable", {
  *   partitionKey: "userId",
  *   sortKey: "sessionId",
  *   attributes: {
@@ -140,18 +142,69 @@ export interface Table extends Resource<
  * });
  * ```
  *
- * @section Runtime Operations
- * @example Read an Item
+ * @example Table with Global Secondary Index
  * ```typescript
- * const getItem = yield* GetItem.bind(table);
- *
- * const response = yield* getItem({
- *   Key: {
- *     pk: { S: "user#123" },
+ * const table = yield* DynamoDB.Table("OrdersTable", {
+ *   partitionKey: "pk",
+ *   sortKey: "sk",
+ *   attributes: {
+ *     pk: "S",
+ *     sk: "S",
+ *     gsi1pk: "S",
+ *     gsi1sk: "S",
  *   },
- *   ConsistentRead: true,
+ *   globalSecondaryIndexes: [{
+ *     IndexName: "GSI1",
+ *     KeySchema: [
+ *       { AttributeName: "gsi1pk", KeyType: "HASH" },
+ *       { AttributeName: "gsi1sk", KeyType: "RANGE" },
+ *     ],
+ *     Projection: { ProjectionType: "ALL" },
+ *   }],
  * });
  * ```
+ *
+ * @section Runtime Operations
+ * Bind DynamoDB operations in the init phase and use them in runtime
+ * handlers. Bindings inject the table name and grant scoped IAM
+ * permissions automatically.
+ *
+ * @example Read and write items
+ * ```typescript
+ * // init
+ * const getItem = yield* DynamoDB.GetItem.bind(table);
+ * const putItem = yield* DynamoDB.PutItem.bind(table);
+ *
+ * return {
+ *   fetch: Effect.gen(function* () {
+ *     // runtime
+ *     yield* putItem({
+ *       Item: { pk: { S: "user#123" }, name: { S: "Alice" } },
+ *     });
+ *     const result = yield* getItem({
+ *       Key: { pk: { S: "user#123" } },
+ *     });
+ *     return yield* HttpServerResponse.json(result.Item);
+ *   }),
+ * };
+ * ```
+ *
+ * @section DynamoDB Streams
+ * Process change data capture events from a DynamoDB table using a
+ * Lambda event source mapping. The stream is enabled automatically
+ * through the binding contract.
+ *
+ * @example Process table changes
+ * ```typescript
+ * // init
+ * yield* DynamoDB.streams(table, {
+ *   StreamViewType: "NEW_AND_OLD_IMAGES",
+ * }).process(
+ *   Effect.fn(function* (record) {
+ *     yield* Effect.log(`${record.eventName}: ${JSON.stringify(record.dynamodb)}`);
+ *   }),
+ * );
+ * ```
  */
 export const Table = Resource<Table>("AWS.DynamoDB.Table");
 

package/src/AWS/EC2/hosted.ts

@@ -223,7 +223,7 @@ export const createEc2HostedSupport = ({
           virtualEntryPlugin(
             (importPath) => `
 import { NodeServices } from "@effect/platform-node";
-import { Stack } from "alchemy-effect/Stack";
+import { Stack } from "alchemy/Stack";
 import * as Config from "effect/Config";
 import * as ConfigProvider from "effect/ConfigProvider";
 import * as Credentials from "@distilled.cloud/aws/Credentials";

package/src/AWS/ECS/Task.ts

@@ -486,7 +486,7 @@ export const TaskProvider = () =>
               virtualEntryPlugin(
                 (importPath) => `
 import { NodeServices } from "@effect/platform-node";
-import { Stack } from "alchemy-effect/Stack";
+import { Stack } from "alchemy/Stack";
 import * as Config from "effect/Config";
 import * as ConfigProvider from "effect/ConfigProvider";
 import * as Credentials from "@distilled.cloud/aws/Credentials";

package/src/AWS/Kinesis/Stream.ts

@@ -170,32 +170,68 @@ export interface Stream extends Resource<
  *
  * `Stream` owns the stream's lifecycle and mutable control-plane configuration,
  * including retention, encryption, monitoring, warm throughput, record size, tags,
- * and stream resource policy.
+ * and stream resource policy. A stream name is auto-generated from the app,
+ * stage, and logical ID unless you provide one explicitly.
  *
  * @section Creating Streams
  * @example On-Demand Stream
  * ```typescript
- * const stream = yield* Stream("OrdersStream");
+ * import * as Kinesis from "alchemy/AWS/Kinesis";
+ *
+ * const stream = yield* Kinesis.Stream("OrdersStream");
  * ```
  *
  * @example Provisioned Stream
  * ```typescript
- * const stream = yield* Stream("AnalyticsStream", {
+ * const stream = yield* Kinesis.Stream("AnalyticsStream", {
  *   streamMode: "PROVISIONED",
  *   shardCount: 2,
  *   retentionPeriodHours: 48,
  * });
  * ```
  *
+ * @example Encrypted Stream
+ * ```typescript
+ * const stream = yield* Kinesis.Stream("SecureStream", {
+ *   encryption: true,
+ *   kmsKeyId: "alias/my-key",
+ * });
+ * ```
+ *
  * @section Runtime Producers
- * @example Put a Record
+ * Bind producer operations in the init phase and use them in runtime
+ * handlers.
+ *
+ * @example Put a record from a handler
  * ```typescript
+ * // init
  * const putRecord = yield* Kinesis.PutRecord.bind(stream);
  *
- * yield* putRecord({
- *   PartitionKey: "order-123",
- *   Data: new TextEncoder().encode(JSON.stringify({ orderId: "123" })),
- * });
+ * return {
+ *   fetch: Effect.gen(function* () {
+ *     // runtime
+ *     yield* putRecord({
+ *       PartitionKey: "order-123",
+ *       Data: new TextEncoder().encode(JSON.stringify({ orderId: "123" })),
+ *     });
+ *     return HttpServerResponse.text("Sent");
+ *   }),
+ * };
+ * ```
+ *
+ * @section Event Sources
+ * Process records from a Kinesis stream using a Lambda event source
+ * mapping.
+ *
+ * @example Process stream records
+ * ```typescript
+ * // init
+ * yield* Kinesis.records(stream).process(
+ *   Effect.fn(function* (record) {
+ *     const data = new TextDecoder().decode(record.data);
+ *     yield* Effect.log(`Received: ${data}`);
+ *   }),
+ * );
  * ```
  */
 export const Stream = Resource<Stream>("AWS.Kinesis.Stream");