@pristine-ts/gcp 2.0.16

package/dist/types/mappers/eventarc-event.mapper.d.ts

@@ -0,0 +1,22 @@
+import { EventIdManager, EventMapperInterface, EventResponse, EventsExecutionOptionsInterface, ExecutionContextInterface } from "@pristine-ts/core";
+import { EventarcEventPayload } from "../event-payloads/eventarc.event-payload";
+/**
+ * Catch-all mapper for CloudEvents that didn't match a more-specific GCP mapper.
+ * Sits at the end of the mapper chain (the more specific mappers — Pub/Sub, Cloud
+ * Storage, Firestore — short-circuit `supportsMapping` for events they own; this
+ * mapper accepts anything CloudEvent-shaped that nobody else claimed).
+ *
+ * Detection: the event has a CloudEvent `specversion` (or just `type` + `source`),
+ * and isn't one of the GCP-specific shapes already handled. The framework calls
+ * `supportsMapping` on every registered mapper; since this one matches broadly,
+ * relying on order alone isn't safe — instead, this mapper checks that the event
+ * is NOT one of the specific shapes already claimed by the dedicated mappers.
+ */
+export declare class EventarcEventMapper implements EventMapperInterface<EventarcEventPayload, void> {
+    private readonly eventIdManager;
+    constructor(eventIdManager: EventIdManager);
+    supportsMapping(rawEvent: any, executionContext: ExecutionContextInterface<any>): boolean;
+    map(rawEvent: any, executionContext: ExecutionContextInterface<any>): EventsExecutionOptionsInterface<EventarcEventPayload>;
+    supportsReverseMapping(eventResponse: EventResponse<EventarcEventPayload, void>, response: any, executionContext: ExecutionContextInterface<any>): boolean;
+    reverseMap(eventResponse: EventResponse<EventarcEventPayload, void>, response: any, executionContext: ExecutionContextInterface<any>): void;
+}

package/dist/types/mappers/firestore-event.mapper.d.ts

@@ -0,0 +1,17 @@
+import { EventIdManager, EventMapperInterface, EventResponse, EventsExecutionOptionsInterface, ExecutionContextInterface } from "@pristine-ts/core";
+import { FirestoreEventPayload } from "../event-payloads/firestore.event-payload";
+/**
+ * Maps a GCP Firestore document-change CloudEvent into a
+ * Pristine `Event<FirestoreEventPayload>`.
+ *
+ * Detection: CloudEvent `type` starts with `google.cloud.firestore.document.v1.`.
+ */
+export declare class FirestoreEventMapper implements EventMapperInterface<FirestoreEventPayload, void> {
+    private readonly eventIdManager;
+    constructor(eventIdManager: EventIdManager);
+    supportsMapping(rawEvent: any, executionContext: ExecutionContextInterface<any>): boolean;
+    map(rawEvent: any, executionContext: ExecutionContextInterface<any>): EventsExecutionOptionsInterface<FirestoreEventPayload>;
+    supportsReverseMapping(eventResponse: EventResponse<FirestoreEventPayload, void>, response: any, executionContext: ExecutionContextInterface<any>): boolean;
+    reverseMap(eventResponse: EventResponse<FirestoreEventPayload, void>, response: any, executionContext: ExecutionContextInterface<any>): void;
+    private findEnum;
+}

package/dist/types/mappers/mappers.d.ts

@@ -0,0 +1,4 @@
+export * from "./cloud-storage-event.mapper";
+export * from "./eventarc-event.mapper";
+export * from "./firestore-event.mapper";
+export * from "./pub-sub-event.mapper";

package/dist/types/mappers/pub-sub-event.mapper.d.ts

@@ -0,0 +1,23 @@
+import { EventIdManager, EventMapperInterface, EventResponse, EventsExecutionOptionsInterface, ExecutionContextInterface } from "@pristine-ts/core";
+import { PubSubEventPayload } from "../event-payloads/pub-sub.event-payload";
+/**
+ * Maps a GCP Pub/Sub push-subscription delivery into a Pristine `Event<PubSubEventPayload>`.
+ *
+ * Pub/Sub push subscriptions deliver a single JSON envelope:
+ *
+ * ```json
+ * { "message": { "data": "<base64>", "messageId": "...", "attributes": {...},
+ *                "publishTime": "...", "orderingKey": "..." },
+ *   "subscription": "projects/p/subscriptions/s" }
+ * ```
+ *
+ * Mirrors `SqsEventMapper`'s shape and DI registration.
+ */
+export declare class PubSubEventMapper implements EventMapperInterface<PubSubEventPayload, void> {
+    private readonly eventIdManager;
+    constructor(eventIdManager: EventIdManager);
+    supportsMapping(rawEvent: any, executionContext: ExecutionContextInterface<any>): boolean;
+    map(rawEvent: any, executionContext: ExecutionContextInterface<any>): EventsExecutionOptionsInterface<PubSubEventPayload>;
+    supportsReverseMapping(eventResponse: EventResponse<PubSubEventPayload, void>, response: any, executionContext: ExecutionContextInterface<any>): boolean;
+    reverseMap(eventResponse: EventResponse<PubSubEventPayload, void>, response: any, executionContext: ExecutionContextInterface<any>): void;
+}

package/dist/types/models/dynamic-collection-name.model.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Model representing the object that the `@dynamicCollectionName` decorator saves in the
+ * registry, mirroring `DynamicTableNameModel` in `@pristine-ts/aws`.
+ */
+export declare class DynamicCollectionNameModel {
+    classConstructor: any;
+    tokenName: string;
+}

package/dist/types/models/eventarc-message.model.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The payload sent to `EventarcClient.publish(...)`. CloudEvent-shaped.
+ */
+export declare class EventarcMessageModel {
+    /**
+     * CloudEvent `type`.
+     */
+    type: string;
+    /**
+     * CloudEvent `source`.
+     */
+    source: string;
+    /**
+     * CloudEvent `subject`, optional.
+     */
+    subject?: string;
+    /**
+     * CloudEvent `data` — opaque payload.
+     */
+    data?: any;
+    /**
+     * CloudEvent `datacontenttype`, e.g. `application/json`.
+     */
+    dataContentType?: string;
+}

package/dist/types/models/models.d.ts

@@ -0,0 +1,3 @@
+export * from "./eventarc-message.model";
+export * from "./pub-sub-message.model";
+export * from "./pub-sub-message-sent-confirmation.model";

package/dist/types/models/pub-sub-message-sent-confirmation.model.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Confirmation returned from `PubSubClient.publish(...)`. Mirrors
+ * `SqsMessageSentConfirmationModel`.
+ */
+export declare class PubSubMessageSentConfirmationModel {
+    messageId: string;
+}

package/dist/types/models/pub-sub-message.model.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The payload sent to `PubSubClient.publish(...)`. Mirrors `EventBridgeMessageModel` in
+ * spirit — a structured input the client uses to build the SDK request.
+ */
+export declare class PubSubMessageModel {
+    /**
+     * The message body. Strings are UTF-8 encoded then base64-encoded on the wire.
+     * Buffers are base64-encoded as-is.
+     */
+    data: string | Buffer;
+    /**
+     * Optional string attributes to attach.
+     */
+    attributes?: {
+        [key: string]: string;
+    };
+    /**
+     * Optional ordering key for ordered delivery.
+     */
+    orderingKey?: string;
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@pristine-ts/gcp",
+  "version": "2.0.16",
+  "description": "",
+  "module": "dist/lib/esm/gcp.module.js",
+  "main": "dist/lib/cjs/gcp.module.js",
+  "types": "dist/types/gcp.module.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json",
+    "prepublish": "npm run build",
+    "test": "jest",
+    "test:cov": "jest --coverage"
+  },
+  "files": [
+    "dist"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@google-cloud/eventarc-publishing": "^2.0.0",
+    "@google-cloud/firestore": "^7.10.0",
+    "@google-cloud/pubsub": "^4.8.0",
+    "@google-cloud/secret-manager": "^5.6.0",
+    "@google-cloud/storage": "^7.14.0",
+    "@pristine-ts/common": "^2.0.16",
+    "@pristine-ts/core": "^2.0.16",
+    "@pristine-ts/logging": "^2.0.16"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "jest": {
+    "transform": {
+      ".(ts|tsx)": "ts-jest"
+    },
+    "globals": {
+      "ts-jest": {
+        "tsconfig": {
+          "strictNullChecks": false
+        }
+      }
+    },
+    "testEnvironment": "node",
+    "testRegex": "(/__tests__/.*|\\.(test|spec))\\.(ts|tsx|js)$",
+    "moduleFileExtensions": [
+      "ts",
+      "tsx",
+      "js"
+    ],
+    "coveragePathIgnorePatterns": [
+      "/node_modules/",
+      "/test/"
+    ],
+    "coverageThreshold": {
+      "global": {
+        "branches": 90,
+        "functions": 95,
+        "lines": 95,
+        "statements": 95
+      }
+    },
+    "collectCoverageFrom": [
+      "src/*.{js,ts}"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/magieno/pristine-ts.git",
+    "directory": "packages/gcp"
+  },
+  "gitHead": "a55d7d59862672a8cbbca4088fed090779b37705"
+}

package/readme.md

@@ -0,0 +1,32 @@
+# @pristine-ts/gcp
+
+Google Cloud Platform integration for Pristine-TS. Mirrors `@pristine-ts/aws`:
+clients, event mappers, decorators, models, options, and results for GCP services.
+
+## Coverage
+
+| GCP service | Client | Event mapper |
+| :--- | :--- | :--- |
+| Firestore (Native mode) | `FirestoreClient` | `FirestoreEventMapper` (CloudEvents) |
+| Cloud Storage | `CloudStorageClient` | `CloudStorageEventMapper` (CloudEvents) |
+| Pub/Sub | `PubSubClient` | `PubSubEventMapper` (push subscription shape) |
+| Secret Manager | `SecretManagerClient` | — |
+| Eventarc | `EventarcClient` | `EventarcEventMapper` (catch-all CloudEvent) |
+
+## Deliberately not implemented
+
+AWS services with no first-party GCP equivalent are not mirrored:
+
+- **SES** — GCP has no native transactional-email service. Use `@pristine-ts/http`
+  against SendGrid/Postmark/etc.
+- **CloudFront** — Cloud CDN is configured at the infra level (Terraform/`gcloud`),
+  no SDK to wrap.
+- **CloudFormation** — Deployment Manager is deprecated; Terraform is the modern
+  path and is out of framework scope.
+- **Kafka / MSK** — Confluent Cloud on GCP has its own SDK; if needed, a dedicated
+  package can be added separately.
+
+See companion packages: `@pristine-ts/gcp-functions` (HTTP entry mappers for Cloud
+Functions / Cloud Run), `@pristine-ts/gcp-identity-platform` (auth),
+`@pristine-ts/gcp-scheduling` (Cloud Scheduler), `@pristine-ts/gcp-trace`
+(Cloud Trace).