@webda/gcp 4.0.0-beta.2 → 4.0.0-beta.3

package/README.md

@@ -13,16 +13,66 @@ This module is part of Webda Application Framework that allows you to quickly de
 
 <!-- README_HEADER -->
 
-This project allows you to use Cloud Storage ... soon
+# @webda/gcp
 
-## Run local tests
+> Google Cloud Platform integration bundle for Webda — Firestore Store, Cloud Storage Binary, Cloud Pub/Sub, GCP Queue, and KMS encryption service in one package.
 
-The test credentials need to be provided by the author
+## When to use it
 
+- You are deploying a Webda application on GCP and need cloud-native backing services.
+- You want to replace `MemoryStore` / `FileBinary` / `MemoryQueue` with GCP-managed equivalents for production.
+- You need envelope encryption via Google Cloud KMS for stored model data.
+
+## Install
+
+```bash
+pnpm add @webda/gcp
+```
+
+## What's inside
+
+- `FireStore` — Firestore-backed Store for any Webda model ([source](./src/services/firestore.ts))
+- `Storage` — Cloud Storage-backed Binary service for file uploads/downloads ([source](./src/services/storage.ts))
+- `GCPQueue` — Cloud Pub/Sub-backed Queue for reliable task delivery ([source](./src/services/queue.ts))
+- `GCPPubSubService` — Cloud Pub/Sub fan-out pub/sub messaging ([source](./src/services/pubsub.ts))
+- `GCPKMSService` — Cloud KMS-based encryption/decryption ([source](./src/services/kms.ts))
+
+## Quick config example
+
+```json
+{
+  "services": {
+    "userStore": {
+      "type": "FireStore",
+      "model": "MyApp/User",
+      "project": "my-gcp-project",
+      "collection": "users"
+    },
+    "uploads": {
+      "type": "Storage",
+      "bucket": "my-app-uploads"
+    },
+    "taskQueue": {
+      "type": "GCPQueue",
+      "topic": "my-app-tasks",
+      "subscription": "my-app-tasks-sub"
+    }
+  }
+}
 ```
-GOOGLE_APPLICATION_CREDENTIALS=`pwd`/webda-dev-750c62811e3b.json yarn test
+
+Authentication uses Application Default Credentials. Set `GOOGLE_APPLICATION_CREDENTIALS` to a service account key file for local development:
+
+```bash
+GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json webda serve
 ```
 
+## Reference
+
+- API reference: see the auto-generated typedoc at `docs/pages/Modules/gcp/`.
+- Source: [`packages/gcp`](https://github.com/loopingz/webda.io/tree/main/packages/gcp)
+- Related: [`@webda/core`](../core) for the `Store`, `Binary`, and `Queue` base classes; [`@webda/async`](../async) for job orchestration on top of GCPQueue; [`@webda/aws`](../aws) for the AWS equivalent.
+
 <!-- README_FOOTER -->
 ## Sponsors
 

package/lib/index.d.ts

@@ -1,5 +1,5 @@
-export * from "./services/firestore.js";
-export * from "./services/pubsub.js";
-export * from "./services/queue.js";
-export * from "./services/storage.js";
+export * from "./services/firestore.service.js";
+export * from "./services/pubsub.service.js";
+export * from "./services/queue.service.js";
+export * from "./services/storage.service.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC"}

package/lib/index.js

@@ -1,5 +1,5 @@
-export * from "./services/firestore.js";
-export * from "./services/pubsub.js";
-export * from "./services/queue.js";
-export * from "./services/storage.js";
+export * from "./services/firestore.service.js";
+export * from "./services/pubsub.service.js";
+export * from "./services/queue.service.js";
+export * from "./services/storage.service.js";
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC"}

package/lib/services/firestore.service.d.ts

@@ -0,0 +1,236 @@
+import { DocumentReference, Firestore } from "@google-cloud/firestore";
+import { MemoryRepository, Store, StoreParameters } from "@webda/core";
+import type { ModelClass, Repository } from "@webda/core";
+import * as WebdaQL from "@webda/ql";
+/**
+ * Definition of a FireStore index
+ */
+export type FireStoreIndex = {
+    [key: string]: "asc" | "desc";
+};
+/**
+ * Stored version of indexes
+ */
+export type FireStoreIndexOrder = {
+    [key: string]: Set<"asc" | "desc">;
+};
+/**
+ * Result of a Firestore find, `filter` is the part of the query that Firestore
+ * could not apply natively and that was applied in memory (`true` if none)
+ */
+export interface FireStoreFindResult<T> {
+    results: T[];
+    filter: WebdaQL.Expression | true;
+    continuationToken?: string;
+}
+/**
+ * Firebase parameters
+ */
+export declare class FireStoreParameters extends StoreParameters {
+    /**
+     * Collection to use
+     */
+    collection: string;
+    /**
+     * Per-model collection overrides.
+     * Maps a model identifier (e.g. "Webda/User") to a collection name.
+     * When not specified, the first model uses `collection` and others use their identifier
+     * lowercased with "/" replaced by "_".
+     */
+    collections?: {
+        [modelIdentifier: string]: string;
+    };
+    /**
+     * To allow efficient query on several fields
+     *
+     * @see https://firebase.google.com/docs/firestore/query-data/queries
+     */
+    compoundIndexes?: FireStoreIndex[];
+    /**
+     * @override
+     * @param params - raw parameters
+     * @returns this
+     */
+    load(params?: any): this;
+}
+/**
+ * Recursively convert a value to what Firestore can store
+ *
+ * Dates are kept as is (Firestore stores them as Timestamp), objects exposing a
+ * `toJSON` (models, binaries) are serialized first, functions and undefined are dropped
+ *
+ * @param value - the value to convert
+ * @returns the Firestore compatible value
+ */
+export declare function toFirestore(value: any): any;
+/**
+ * Recursively replace Timestamp by Date
+ * @param doc - the Firestore document data
+ * @returns the data with Date objects
+ */
+export declare function giveDatesBack(doc: any): any;
+/**
+ * Firestore-backed repository for a single model class
+ *
+ * Every object is stored as a document of the collection, keyed by its primary key.
+ * The inherited MemoryRepository is only used for its helpers, every storage
+ * method hits Firestore.
+ */
+export declare class FireStoreRepository<T extends ModelClass> extends MemoryRepository<T> {
+    protected readonly firestore: Firestore;
+    protected readonly collection: string;
+    protected readonly log: (level: any, ...args: any[]) => void;
+    /**
+     * Compound indexes available, keyed by the sorted fields joined with "/"
+     */
+    protected compoundIndexes: {
+        [key: string]: FireStoreIndexOrder;
+    };
+    /**
+     * @param model - the model class
+     * @param pks - primary key field names
+     * @param firestore - the Firestore client
+     * @param collection - the collection name
+     * @param indexes - compound indexes declared on the store
+     * @param log - logger of the store
+     */
+    constructor(model: T, pks: string[], firestore: Firestore, collection: string, indexes?: FireStoreIndex[], log?: (level: any, ...args: any[]) => void);
+    /**
+     * The backing collection name for this repository's model
+     * @returns the collection name
+     */
+    getCollection(): string;
+    /**
+     * Get Document Reference
+     * @param primaryKey - the object or primary key
+     * @returns the document reference
+     */
+    getDocumentRef(primaryKey: any): DocumentReference;
+    /**
+     * Deserialize a Firestore document into a model instance
+     * @param data - the document data
+     * @returns the model instance
+     */
+    protected fromFirestore(data: any): InstanceType<T>;
+    /**
+     * Verify a write condition
+     * @param uid - the object key, for the error
+     * @param data - the current data
+     * @param field - the field to check
+     * @param condition - the expected value
+     */
+    protected checkFirestoreCondition(uid: string, data: any, field: string, condition: any): void;
+    /**
+     * Translate Firestore not found error
+     * @param uid - the object key
+     * @param err - the error raised
+     */
+    protected translateError(uid: string, err: any): never;
+    /** @override */
+    get(primaryKey: any): Promise<any>;
+    /** @override */
+    exists(primaryKey: any): Promise<boolean>;
+    /** @override */
+    create(data: any, save?: boolean): Promise<any>;
+    /**
+     * Implement both update and patch
+     * @param merge - merge with the existing document (patch) or replace it (update)
+     * @param primaryKey - the object or primary key
+     * @param data - the data to write
+     * @param conditionField - the field to check
+     * @param condition - the expected value
+     */
+    protected setDocument(merge: boolean, primaryKey: any, data: any, conditionField?: string, condition?: any): Promise<void>;
+    /** @override */
+    update(data: any, conditionField?: any, condition?: any): Promise<void>;
+    /** @override */
+    patch(primaryKey: any, data: any, conditionField?: any, condition?: any): Promise<void>;
+    /** @override */
+    delete(primaryKey: any, conditionField?: any, condition?: any): Promise<void>;
+    /** @override */
+    removeAttribute(primaryKey: any, attribute: any, conditionField?: any, condition?: any): Promise<void>;
+    /** @override */
+    incrementAttributes(primaryKey: any, info: any, _conditionField?: any, _condition?: any): Promise<void>;
+    /** @override */
+    upsertItemToCollection(primaryKey: any, collection: any, item: any, index?: number, itemWriteConditionField?: any, itemWriteCondition?: any): Promise<void>;
+    /** @override */
+    deleteItemFromCollection(primaryKey: any, collection: any, index: number, itemWriteConditionField?: any, itemWriteCondition?: any): Promise<void>;
+    /**
+     * Run a parsed query against Firestore
+     *
+     * Firestore has strong limitations on what can be queried natively, the part of the
+     * query that cannot be translated is applied in memory and returned as `filter`
+     *
+     * @param parsedQuery - the parsed WebdaQL query
+     * @returns the results, the in-memory filter and the continuation token
+     */
+    find(parsedQuery: WebdaQL.Query): Promise<FireStoreFindResult<InstanceType<T>>>;
+    /**
+     * Manage OrderBy complex condition on Firebase
+     * @param query - the Firestore query
+     * @param orderBy - the requested order
+     * @param rangeAttribute - the attribute used in a range condition if any
+     * @returns the Firestore query with ordering
+     */
+    handleOrderBy(query: FirebaseFirestore.Query<FirebaseFirestore.DocumentData>, orderBy: WebdaQL.OrderBy[], rangeAttribute: string): FirebaseFirestore.Query<FirebaseFirestore.DocumentData>;
+    /** @override */
+    query(query: string | any): Promise<{
+        results: InstanceType<T>[];
+        continuationToken?: string;
+    }>;
+    /** @override */
+    iterate(query: string): AsyncGenerator<InstanceType<T>, any, any>;
+    /**
+     * Delete every document of the collection (used in tests)
+     */
+    clear(): Promise<void>;
+}
+/**
+ * Implement Firebase abstraction within Webda
+ *
+ * @WebdaModda GoogleCloudFireStore
+ */
+export default class FireStore<K extends FireStoreParameters = FireStoreParameters> extends Store<K> {
+    firestore: Firestore;
+    /**
+     * Create the Firestore client
+     * @override
+     */
+    computeParameters(): void;
+    /**
+     * Terminate the Firestore client
+     * @override
+     */
+    stop(): Promise<void>;
+    /**
+     * Resolve the collection name for a given model class
+     *
+     * Resolution order:
+     * 1. `parameters.collections[meta.Identifier]` — explicit per-model override
+     * 2. `parameters.collection` for the first model configured or when a single model is managed
+     * 3. Default — model identifier lowercased with "/" replaced by "_"
+     *
+     * @param model - the model class
+     * @returns the collection name
+     */
+    resolveCollection(model: ModelClass): string;
+    /**
+     * Build and return a FireStoreRepository for the given model
+     *
+     * The result is cached per model class via `@InstanceCache`.
+     * @param model - the model class
+     * @returns a repository backed by Firestore
+     */
+    getRepository<T extends ModelClass>(model: T): Repository<T>;
+    /**
+     * Return the underlying FireStoreRepository for each model this store manages
+     * @returns the per-model FireStoreRepository instances
+     */
+    getRepositories(): FireStoreRepository<any>[];
+    /**
+     * Delete every document of the managed collections (used in tests)
+     */
+    __clean(): Promise<void>;
+}
+export { FireStore };
+//# sourceMappingURL=firestore.service.d.ts.map

package/lib/services/firestore.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore.service.d.ts","sourceRoot":"","sources":["../../src/services/firestore.service.ts"],"names":[],"mappings":"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"}