add basic function implementation

packages/backend-function/.npmignore

@@ -0,0 +1,14 @@
+# Be very careful editing this file. It is crafted to work around [this issue](https://github.com/npm/npm/issues/4479)
+
+# First ignore everything
+**/*
+
+# Then add back in transpiled js and ts declaration files
+!lib/**/*.js
+!lib/**/*.d.ts
+
+# Then ignore test js and ts declaration files
+*.test.js
+*.test.d.ts
+
+# This leaves us with including only js and ts declaration files of functional code

packages/backend-function/api-extractor.json

@@ -0,0 +1,3 @@
+{
+  "extends": "../../api-extractor.base.json"
+}

packages/backend-function/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@aws-amplify/backend-function",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "require": "./lib/index.js"
+    }
+  },
+  "types": "lib/index.d.ts",
+  "scripts": {
+    "update:api": "api-extractor run --local"
+  },
+  "dependencies": {
+    "@aws-amplify/function-construct": "^0.1.0",
+    "execa": "^7.1.1"
+  },
+  "devDependencies": {
+    "@aws-amplify/backend-engine": "^0.1.0",
+    "@aws-amplify/plugin-types": "^0.1.0"
+  },
+  "peerDependencies": {
+    "aws-cdk-lib": "~2.68.0",
+    "constructs": "^10.0.0"
+  }
+}

packages/backend-function/src/factory.test.ts

@@ -0,0 +1,67 @@
+import { beforeEach, describe, it } from 'node:test';
+import { AmplifyFunctionFactory } from './factory.js';
+import { App, Stack } from 'aws-cdk-lib';
+import {
+  NestedStackResolver,
+  SingletonConstructContainer,
+  StackMetadataBackendOutputStorageStrategy,
+} from '@aws-amplify/backend-engine';
+import {
+  BackendOutputEntry,
+  BackendOutputStorageStrategy,
+  ConstructContainer,
+} from '@aws-amplify/plugin-types';
+import assert from 'node:assert';
+import * as fs from 'fs';
+
+describe('AmplifyFunctionFactory', () => {
+  let constructContainer: ConstructContainer;
+  let outputStorageStrategy: BackendOutputStorageStrategy<BackendOutputEntry>;
+
+  beforeEach(() => {
+    const app = new App();
+    const stack = new Stack(app, 'testStack');
+
+    constructContainer = new SingletonConstructContainer(
+      new NestedStackResolver(stack)
+    );
+
+    outputStorageStrategy = new StackMetadataBackendOutputStorageStrategy(
+      stack
+    );
+  });
+
+  it('creates singleton function instance', () => {
+    const functionFactory = new AmplifyFunctionFactory({
+      name: 'testFunc',
+      codeLocation: '../test-assets/test-lambda',
+    });
+    const instance1 = functionFactory.getInstance({
+      constructContainer,
+      outputStorageStrategy,
+    });
+    const instance2 = functionFactory.getInstance({
+      constructContainer,
+      outputStorageStrategy,
+    });
+    assert.strictEqual(instance1, instance2);
+  });
+
+  it('executes build command from directory where constructor is used', () => {
+    // the build command creates a test.txt file.
+    // We use the existence of this file as an indicator that the build command ran successfully
+    const relativeTestFileLocation = '../test.txt';
+
+    new AmplifyFunctionFactory({
+      name: 'testFunc',
+      codeLocation: '../test-assets/test-lambda',
+      buildCommand: `touch ${relativeTestFileLocation}`,
+    }).getInstance({ constructContainer, outputStorageStrategy });
+
+    const testFilePath = new URL(relativeTestFileLocation, import.meta.url);
+
+    assert.ok(fs.existsSync(testFilePath));
+
+    fs.unlinkSync(testFilePath);
+  });
+});