chore: wip vitest flow

Author: Ehesp

integration_test/.gcloudignore

@@ -1,8 +1,72 @@
-node_modules/
-generated/
-.test-artifacts/
+# Ignored as the test runner will generate this file
+firebase.json
+
+# Logs
+logs
 *.log
-.DS_Store
-package-lock.json
-firebase-debug.log
-sa.json
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+firebase-debug.log*
+firebase-debug.*.log*
+
+# Firebase cache
+.firebase/
+
+# Firebase config
+
+# Uncomment this if you'd like others to create their own Firebase project.
+# For a team working on the same Firebase project(s), it is recommended to leave
+# it commented so all members can deploy to the same project(s) in .firebaserc.
+# .firebaserc
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+
+# dataconnect generated files
+.dataconnect

integration_test/.gitignore

@@ -0,0 +1,77 @@
+# Plan
+
+# Structure
+
+integration_test
+  cli.ts
+  tests <- vitest
+    firestore.test.ts
+    database.test.ts
+  functions/
+    package.json <-- "dependency": "firebase-functions": "file:../../"
+    src/
+      firestore.ts
+      database.ts etc
+      utils/ ...
+  .gitignore <-- firebase.json
+
+# Functions files
+
+```ts
+exports.firestoreOnCreate = onDocumentCreate((event) => {
+  firestore.collection(...).doc(...).set(event)';
+})
+```
+
+```ts
+exports.firestoreOnCreate = onDocumentCreate((event) => {
+  await sendEvent(event);
+})
+
+let topic;
+
+async function(name: string, event: any): Promise<void> {
+  topic ??= await pubsub.createTopic(process.env.RUN_ID);
+  await topic.publishMessage({ name, event })
+}
+```
+
+# Test Files
+
+```
+describe('triggers the correct document event', () => {
+  beforeAll(() => {
+    let event = await new Promise((resolve) => {
+      setUpEventListener('firestoreOnCreate', (event) => {
+        resolve(event);
+      });
+
+      await admin().firestore().collection(process.env.RUN_ID).doc('foo');
+    });
+    
+  });
+
+  test('whatever...');
+});
+```
+
+# CLI
+
+1. Generate a run id - 1234
+2. Run build command in functions dir
+3. write a `functions.json` file, which includes:
+
+```
+"functions": [
+  {
+    "source": "functions/dist",
+    "codebase": "1234" // generated id
+  },
+]
+```
+
+4. spawns `RUN_ID=1234 firebase:deploy --only functions`
+5. waits....
+6. `RUN_ID=1234 vitest run`
+7. On success or error: `firebase:functions delete 1234`
+