feat(sdk): addfile() is a preflight method which adds file from abs…

…olute path (#3801)

## Checklist

- [x] Title matches [Winglang's style guide](https://www.winglang.io/contributing/start-here/pull_requests#how-are-pull-request-titles-formatted)
- [ ] Description explains motivation and solution
- [x] Tests added (always)
- [x] Docs updated (only required for features)
- [ ] Added `pr/e2e-full` label if this feature requires end-to-end testing

*By submitting this pull request, I confirm that my contribution is made under the terms of the [Wing Cloud Contribution License](https://github.com/winglang/wing/blob/main/CONTRIBUTION_LICENSE.md)*.

docs/docs/04-standard-library/01-cloud/bucket.md

@@ -150,6 +150,7 @@ new cloud.Bucket(props?: BucketProps);
 
 | **Name** | **Description** |
 | --- | --- |
+| <code><a href="#@winglang/sdk.cloud.Bucket.addFile">addFile</a></code> | Add a file to the bucket from system folder. |
 | <code><a href="#@winglang/sdk.cloud.Bucket.addObject">addObject</a></code> | Add a file to the bucket that is uploaded when the app is deployed. |
 | <code><a href="#@winglang/sdk.cloud.Bucket.onCreate">onCreate</a></code> | Run an inflight whenever a file is uploaded to the bucket. |
 | <code><a href="#@winglang/sdk.cloud.Bucket.onDelete">onDelete</a></code> | Run an inflight whenever a file is deleted from the bucket. |
@@ -174,6 +175,40 @@ new cloud.Bucket(props?: BucketProps);
 
 ---
 
+##### `addFile` <a name="addFile" id="@winglang/sdk.cloud.Bucket.addFile"></a>
+
+```wing
+addFile(key: str, path: str, encoding?: str): void
+```
+
+Add a file to the bucket from system folder.
+
+###### `key`<sup>Required</sup> <a name="key" id="@winglang/sdk.cloud.Bucket.addFile.parameter.key"></a>
+
+- *Type:* str
+
+The key or name to associate with the file.
+
+---
+
+###### `path`<sup>Required</sup> <a name="path" id="@winglang/sdk.cloud.Bucket.addFile.parameter.path"></a>
+
+- *Type:* str
+
+The path to the file on the local system.
+
+---
+
+###### `encoding`<sup>Optional</sup> <a name="encoding" id="@winglang/sdk.cloud.Bucket.addFile.parameter.encoding"></a>
+
+- *Type:* str
+
+The encoding to use when reading the file.
+
+Defaults to "utf-8".
+
+---
+
 ##### `addObject` <a name="addObject" id="@winglang/sdk.cloud.Bucket.addObject"></a>
 
 ```wing

examples/tests/sdk_tests/bucket/add_file.w

@@ -0,0 +1,12 @@
+bring cloud;
+
+let b = new cloud.Bucket();
+
+b.addFile("file1.txt", "testFiles/test1.txt");
+b.addFile("file2.txt", "testFiles/test2.txt");
+
+test "addObject" {
+  assert(b.list().length == 2);
+  assert(b.get("file1.txt") == "test1");
+  assert(b.get("file2.txt") == "test2");  
+}

examples/tests/sdk_tests/bucket/testFiles/test1.txt

@@ -0,0 +1 @@
+test1

examples/tests/sdk_tests/bucket/testFiles/test2.txt

@@ -0,0 +1 @@
+test2

libs/wingsdk/src/cloud/bucket.ts

@@ -1,3 +1,5 @@
+import * as fs from "fs";
+import { isAbsolute, resolve } from "path";
 import { Construct } from "constructs";
 import { Topic } from "./topic";
 import { fqnForType } from "../constants";
@@ -41,12 +43,14 @@ export abstract class Bucket extends Resource {
 
   /** @internal */
   protected readonly _topics = new Map<BucketEventType, Topic>();
+  private scope: Construct;
 
   constructor(scope: Construct, id: string, props: BucketProps = {}) {
     super(scope, id);
 
     this.display.title = "Bucket";
     this.display.description = "A cloud object store";
+    this.scope = scope;
 
     this._addInflightOps(
       BucketInflightMethods.DELETE,
@@ -73,6 +77,32 @@ export abstract class Bucket extends Resource {
    */
   public abstract addObject(key: string, body: string): void;
 
+  /**
+   * Add a file to the bucket from system folder
+   *
+   * @param {string} key - The key or name to associate with the file.
+   * @param {string} path - The path to the file on the local system.
+   * @param {BufferEncoding} encoding - The encoding to use when reading the file. Defaults to "utf-8".
+   */
+
+  public addFile(
+    key: string,
+    path: string,
+    encoding: BufferEncoding = "utf-8"
+  ): void {
+    if (isAbsolute(path)) {
+      path = path;
+    } else {
+      if (!App.of(this.scope).entrypointDir) {
+        throw new Error("Missing environment variable: WING_SOURCE_DIR");
+      }
+      path = resolve(App.of(this.scope).entrypointDir, path);
+    }
+    const data = fs.readFileSync(path, { encoding: encoding });
+
+    this.addObject(key, data);
+  }
+
   /**
    * Creates a topic for subscribing to notification events
    * @param actionType

libs/wingsdk/test/sim-app.ts

@@ -17,7 +17,7 @@ export class SimApp extends sim.App {
   private functionIndex: number = 0;
 
   constructor() {
-    super({ outdir: mkdtemp() });
+    super({ outdir: mkdtemp(), entrypointDir: __dirname });
 
     // symlink the node_modules so we can test imports and stuffs
     fs.symlinkSync(