feat: initial code commit

Author: cabljac

.gitignore

@@ -0,0 +1,2 @@
+lib
+node_modules

README.md

@@ -1 +1,38 @@
-# firestore-onwrite-processor
+# firebase-extension-utilites
+
+## firestore-onwrite-processor
+
+This provides a processor class which you can pass to your firestore onWrite call, and will handle the state of processes on firestore fields for you.
+
+```typescript
+import {
+  FirestoreOnWriteProcessor,
+  FirestoreOnWriteProcess,
+} from "../firestore-onwrite-processor";
+
+const myProcess = new FirestoreOnWriteProcess({
+  id: "myProcessId",
+  fieldDependencyArray: ["input"],
+  processFn: ({ input }) => {
+    // do stuff here
+    return { output };
+  },
+});
+
+const myProcessor = new FirestoreOnWriteProcessor({
+  processes: [myProcess],
+});
+
+export const myFunction = functions.firestore
+  .document(COLLECTION_NAME / { id })
+  .onWrite(process);
+```
+
+TODO:
+
+- change signature of above, process function should be main argument and then should pass `options` which include optional id etc.
+
+Used in:
+
+- PaLM extensions
+- Gemini extensions

_emulator/.firebaserc

@@ -0,0 +1,6 @@
+{
+  "projects": {
+    "default": "extensions-testing"
+  },
+  "targets": {}
+}

_emulator/.gitignore

@@ -0,0 +1,66 @@
+# Logs
+logs
+*.log
+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

_emulator/firebase.json

@@ -0,0 +1,16 @@
+{
+  "emulators": {
+    "ui": {
+      "enabled": true
+    },
+    "firestore": {
+      "host": "127.0.0.1",
+      "port": 8080
+    }
+  },
+  "firestore": {
+    "rules": "firestore.rules",
+    "indexes": "firestore.indexes.json",
+    "host": "test-firestore.sandbox.googleapis.com"
+  }
+}

_emulator/firestore.indexes.json

@@ -0,0 +1,4 @@
+{
+  "indexes": [],
+  "fieldOverrides": []
+}

_emulator/firestore.rules

@@ -0,0 +1,17 @@
+rules_version = '2';
+service cloud.firestore {
+  match /databases/{database}/documents {
+    match /{document=**} {
+      // This rule allows anyone with your database reference to view, edit,
+      // and delete all data in your database. It is useful for getting
+      // started, but it is configured to expire after 30 days because it
+      // leaves your app open to attackers. At that time, all client
+      // requests to your database will be denied.
+      //
+      // Make sure to write security rules for your app before that time, or
+      // else all client requests to your database will be denied until you
+      // update your rules.
+      allow read, write;
+    }
+  }
+}

jest.config.js

@@ -0,0 +1,23 @@
+const packageJson = require("./package.json");
+
+module.exports = {
+  name: packageJson.name,
+  displayName: packageJson.name,
+  preset: "ts-jest",
+  testMatch: ["**/*.test.ts"],
+  moduleNameMapper: {
+    "firebase-admin/eventarc":
+      "<rootDir>/node_modules/firebase-admin/lib/eventarc",
+    "firebase-admin/auth": "<rootDir>/node_modules/firebase-admin/lib/auth",
+    "firebase-admin/app": "<rootDir>/node_modules/firebase-admin/lib/app",
+    "firebase-admin/database":
+      "<rootDir>/node_modules/firebase-admin/lib/database",
+    "firebase-admin/firestore":
+      "<rootDir>/node_modules/firebase-admin/lib/firestore",
+    "firebase-admin/functions":
+      "<rootDir>/node_modules/firebase-admin/lib/functions",
+    "firebase-functions/v2": "<rootDir>/node_modules/firebase-functions/lib/v2",
+    "firebase-admin/extensions":
+      "<rootDir>/node_modules/firebase-admin/lib/extensions",
+  },
+};