Fireworkers 

Work in progress, expect bugs and missing features.

A library to use Cloud Firestore inside Cloudflare Workers.

Install

``bash
npm install fireworkers


OR

yarn add fireworkers

OR

pnpm add fireworkers
`

Usage

`typescript
import * as Firestore from 'fireworkers';

const db = await Firestore.init({
uid: 'user1234',
project_id: 'my-project',
client_email: 'abc-123@a-b-c-123.iam.gserviceaccount.com',
private_key: '-----BEGIN PRIVATE KEY-----...',
private_key_id: 'OdxPtETQKf1o2YvMTTLBzsJ3OYdiPcx7NlFE2ZAk',
claims: {
premium_account: true,
},
});

const todo = await Firestore.get(db, 'todos', 'aDyjLiTViX1G7HyF74Ax');
`

API

$3

Returns a DB instance. Requires a service account.

#### options.uid

Type: string

The unique identifier of the signed-in user, between 1-36 characters long.

#### options.project_id

Type: string

The project_id defined in the serviceAccountKey.json.

#### options.client_email

Type: string

The client_email defined in the serviceAccountKey.json.

#### options.private_key

Type: string

The private_key defined in the serviceAccountKey.json.

#### options.private_key_id

Type: string

The private_key_id defined in the serviceAccountKey.json.

#### (Optional) options.claims

Type: Record | undefined

Optional custom claims to include in the Security Rules auth / request.auth variables.

`typescript
const db = await Firestore.init({
uid: 'user1234',
project_id: 'my-project',
client_email: 'abc-123@a-b-c-123.iam.gserviceaccount.com',
private_key: '-----BEGIN PRIVATE KEY-----...',
private_key_id: 'OdxPtETQKf1o2YvMTTLBzsJ3OYdiPcx7NlFE2ZAk',
claims: {
premium_account: true,
},
});
`

---

$3

Gets a single document.

#### db

Type: DB

The DB instance.

#### document_path

Type: string

The document path, usually defined as {collection_id}/{document_id}.

Allows nested documents like {collection_id}/{document_id}/{nested_collection_id}/{nested_document_id}.

It can either be defined using a single string like:

`typescript
const todo = await Firestore.get(db, 'todos/aDyjLiTViX1G7HyF74Ax');
`

Or multiple params like:

`typescript
const todo = await Firestore.get(db, 'todos', 'aDyjLiTViX1G7HyF74Ax');
`

---

$3

Creates a new document.

#### db

Type: DB

The DB instance.

#### collection_path

Type: string

The collection path, usually defined as {collection_id}.

Allows nested collections like {collection_id}/{document_id}/{nested_collection_id}.

Nested collections can either be defined using a single string like todo/aDyjLiTViX1G7HyF74Ax/tasks or by passing multiple params like 'todo', 'aDyjLiTViX1G7HyF74Ax', 'tasks'.

#### fields

Type: Record

The document fields.

`typescript
const newTodo = await Firestore.create(db, 'todos', {
title: 'Win the lottery',
completed: false,
});
`

---

$3

Updates fields in a document. The update will fail if applied to a document that does not exist.

Implements the same functionality as Firestore's updateDoc.

#### db

Type: DB

The DB instance.

#### document_path

Type: string

The document path, defined like in get.

#### fields

Type: Record

The fields to update.

`typescript
const updatedTodo = await Firestore.update(db, 'todos', 'aDyjLiTViX1G7HyF74Ax', {
completed: false,
});
`

---

$3

Writes to a document. If the document does not yet exist, it will be created. If you provide merge, the provided data can be merged into an existing document.

Implements the same functionality as Firestore's setDoc.

#### db

Type: DB

The DB instance.

#### document_path

Type: string

The document path, defined like in get.

#### fields

Type: Record

The fields to update.

#### (Optional) options.merge

Type: boolean

If set to true, the provided data will be merged into an existing document instead of overwriting.

`typescript
const updatedTodo = await Firestore.set(
db,
'todos',
'aDyjLiTViX1G7HyF74Ax',
{ completed: false },
{ merge: true }
);
`

---

$3

Removes a document.

#### db

Type: DB

The DB instance.

#### document_path

Type: string

The document path, defined like in get.

`typescript
const todo = await Firestore.remove(db, 'todos', 'aDyjLiTViX1G7HyF74Ax');
`

---

$3

Runs a query.

#### db

Type: DB

The DB instance.

#### query

Type: StructuredQuery

A StructuredQuery object.

`typescript
const todos = await Firestore.query(db, {
from: [{ collectionId: 'todos' }],

where: {
fieldFilter: {
field: {
fieldPath: 'owner',
},
op: 'EQUAL',
value: {
stringValue: 'user1234',
},
},
},
});
`

TypeScript

This library has first-class TypeScript support.

To define a document interface, you can pass a generic like so:

`typescript
type Todo = {
title: string;
completed: boolean;
};

const todo = await Firestore.get(db, 'todos', 'aDyjLiTViX1G7HyF74Ax');
``