@pristine-ts/gcp 2.0.16

package/dist/types/clients/clients.d.ts

@@ -0,0 +1,5 @@
+export * from "./cloud-storage.client";
+export * from "./eventarc.client";
+export * from "./firestore.client";
+export * from "./pub-sub.client";
+export * from "./secret-manager.client";

package/dist/types/clients/cloud-storage.client.d.ts

@@ -0,0 +1,26 @@
+import { LogHandlerInterface } from "@pristine-ts/logging";
+import { Storage } from "@google-cloud/storage";
+import { Readable } from "stream";
+import { CloudStorageClientInterface } from "../interfaces/cloud-storage-client.interface";
+import { GcpClientOptionsInterface } from "../interfaces/client-options.interface";
+import { CloudStoragePresignedOperationTypeEnum } from "../enums/cloud-storage-presigned-operation-type.enum";
+/**
+ * Client for Google Cloud Storage. Mirrors `S3Client` in `@pristine-ts/aws`.
+ */
+export declare class CloudStorageClient implements CloudStorageClientInterface {
+    private readonly logHandler;
+    private readonly projectId;
+    private client?;
+    constructor(logHandler: LogHandlerInterface, projectId: string);
+    getClient(): Storage;
+    get(bucketName: string, key: string, options?: Partial<GcpClientOptionsInterface>): Promise<Buffer>;
+    getObjectBodyAsArrayBuffer(bucketName: string, key: string, options?: Partial<GcpClientOptionsInterface>): Promise<ArrayBuffer>;
+    listKeys(bucketName: string, prefix?: string, options?: Partial<GcpClientOptionsInterface>): Promise<string[]>;
+    upload(bucketName: string, key: string, data: Buffer | string | Readable, contentType?: string, contentEncoding?: string, options?: Partial<GcpClientOptionsInterface>): Promise<void>;
+    download(bucketName: string, key: string, options?: Partial<GcpClientOptionsInterface>): Promise<Readable>;
+    deleteObject(bucketName: string, key: string, options?: Partial<GcpClientOptionsInterface>): Promise<void>;
+    /**
+     * Creates a V4 signed URL granting `operation` on the object for `expiresInSeconds`.
+     */
+    createSignedUrl(bucketName: string, key: string, operation: CloudStoragePresignedOperationTypeEnum, expiresInSeconds?: number): Promise<string>;
+}

package/dist/types/clients/eventarc.client.d.ts

@@ -0,0 +1,26 @@
+import { LogHandlerInterface } from "@pristine-ts/logging";
+import { PublisherClient } from "@google-cloud/eventarc-publishing";
+import { EventarcClientInterface } from "../interfaces/eventarc-client.interface";
+import { EventarcMessageModel } from "../models/eventarc-message.model";
+import { GcpClientOptionsInterface } from "../interfaces/client-options.interface";
+/**
+ * Client for publishing CloudEvents through Eventarc. Mirrors `EventBridgeClient` in
+ * `@pristine-ts/aws`. Uses the Eventarc Publishing API (`PublisherClient`) which lets
+ * services emit CloudEvents to a channel for routing.
+ */
+export declare class EventarcClient implements EventarcClientInterface {
+    private readonly logHandler;
+    private readonly projectId;
+    private readonly region;
+    private client?;
+    constructor(logHandler: LogHandlerInterface, projectId: string, region: string);
+    getClient(): PublisherClient;
+    /**
+     * Publish one or more CloudEvents to an Eventarc channel.
+     *
+     * @param events One event or a batch.
+     * @param channel Channel id (bare or fully-qualified). Defaults to the configured
+     *   project's default region channel `projects/{p}/locations/{r}/channels/default`.
+     */
+    publish(events: EventarcMessageModel | EventarcMessageModel[], channel?: string, options?: Partial<GcpClientOptionsInterface>): Promise<void>;
+}

package/dist/types/clients/firestore.client.d.ts

@@ -0,0 +1,47 @@
+import { LogHandlerInterface } from "@pristine-ts/logging";
+import { Firestore } from "@google-cloud/firestore";
+import { FirestoreClientInterface } from "../interfaces/firestore-client.interface";
+/**
+ * Client for Google Cloud Firestore (Native mode). Provides typed CRUD against a
+ * model class plus a `findBySecondaryIndex` for indexed field-equality lookups.
+ *
+ * Document↔object mapping uses the class name (lowercased) as the collection key;
+ * fields are persisted verbatim via property copy. A typed decorator-based mapper
+ * (`@firestoreCollection` / `@firestoreField`) is a future extension.
+ */
+export declare class FirestoreClient implements FirestoreClientInterface {
+    private readonly logHandler;
+    private readonly projectId;
+    private client?;
+    constructor(logHandler: LogHandlerInterface, projectId: string);
+    getClient(): Firestore;
+    /**
+     * Resolves the Firestore collection name for a model class — the class name
+     * lowercased.
+     */
+    private getCollectionName;
+    get<T>(classType: {
+        new (): T;
+    }, id: string): Promise<T | undefined>;
+    list<T>(classType: {
+        new (): T;
+    }, options?: {
+        limit?: number;
+        startAfter?: any;
+    }): Promise<T[]>;
+    create<T>(item: T): Promise<T>;
+    update<T>(item: T): Promise<T>;
+    save<T>(item: T): Promise<T>;
+    delete<T>(classType: {
+        new (): T;
+    }, id: string): Promise<void>;
+    /**
+     * Find documents by a field-equality predicate. Firestore requires a composite index
+     * for compound queries; for the single-field case this returns immediately.
+     */
+    findBySecondaryIndex<T>(classType: {
+        new (): T;
+    }, field: string, value: any, options?: {
+        limit?: number;
+    }): Promise<T[]>;
+}

package/dist/types/clients/pub-sub.client.d.ts

@@ -0,0 +1,23 @@
+import { LogHandlerInterface } from "@pristine-ts/logging";
+import { PubSub } from "@google-cloud/pubsub";
+import { PubSubClientInterface } from "../interfaces/pub-sub-client.interface";
+import { PubSubMessageModel } from "../models/pub-sub-message.model";
+import { PubSubMessageSentConfirmationModel } from "../models/pub-sub-message-sent-confirmation.model";
+import { GcpClientOptionsInterface } from "../interfaces/client-options.interface";
+/**
+ * Client for Google Cloud Pub/Sub. Mirrors `SqsClient` (publish-side) and the topic
+ * half of EventBridge in `@pristine-ts/aws`.
+ */
+export declare class PubSubClient implements PubSubClientInterface {
+    private readonly logHandler;
+    private readonly projectId;
+    private client?;
+    constructor(logHandler: LogHandlerInterface, projectId: string);
+    getClient(): PubSub;
+    /**
+     * Publishes a single message to a topic. `topic` accepts either a bare topic name
+     * (e.g. `"my-topic"`) or a fully-qualified resource name
+     * (`"projects/my-proj/topics/my-topic"`).
+     */
+    publish(topic: string, message: PubSubMessageModel, options?: Partial<GcpClientOptionsInterface>): Promise<PubSubMessageSentConfirmationModel>;
+}

package/dist/types/clients/secret-manager.client.d.ts

@@ -0,0 +1,24 @@
+import { LogHandlerInterface } from "@pristine-ts/logging";
+import { SecretManagerServiceClient } from "@google-cloud/secret-manager";
+import { SecretManagerClientInterface } from "../interfaces/secret-manager-client.interface";
+import { GcpClientOptionsInterface } from "../interfaces/client-options.interface";
+/**
+ * Client for Google Cloud Secret Manager. Mirrors `SecretsManagerClient`.
+ *
+ * `secretName` accepts either a bare secret id (e.g. `"my-secret"`, in which case the
+ * latest version of the secret in the configured project is fetched) or a fully
+ * qualified version resource name
+ * (`"projects/p/secrets/my-secret/versions/latest"`).
+ */
+export declare class SecretManagerClient implements SecretManagerClientInterface {
+    private readonly logHandler;
+    private readonly projectId;
+    private client?;
+    constructor(logHandler: LogHandlerInterface, projectId: string);
+    getClient(): SecretManagerServiceClient;
+    private toVersionResourceName;
+    getSecret(secretName: string, options?: Partial<GcpClientOptionsInterface>): Promise<{
+        [key: string]: string;
+    }>;
+    getSecretKey(secretName: string, key: string, options?: Partial<GcpClientOptionsInterface>): Promise<string>;
+}

package/dist/types/decorators/decorators.d.ts

@@ -0,0 +1 @@
+export * from "./dynamic-collection-name.decorator";

package/dist/types/decorators/dynamic-collection-name.decorator.d.ts

@@ -0,0 +1,22 @@
+import { DynamicCollectionNameModel } from "../models/dynamic-collection-name.model";
+/**
+ * Symbol used to stamp the resolved Firestore collection name onto a class prototype.
+ * Mirrors `DynamoDbTable` from `@awslabs-community-fork/dynamodb-data-mapper`.
+ */
+export declare const FirestoreCollection: unique symbol;
+/**
+ * The registry where the Firestore collection names are saved.
+ */
+export declare const dynamicCollectionNameRegistry: DynamicCollectionNameModel[];
+/**
+ * This decorator is placed on a class that will be used with Firestore.
+ * It registers the class against a configuration token name; during `GcpModule.afterInit`,
+ * the token is resolved from the DI container (or from an environment variable as a
+ * fallback) and the resulting collection name is stamped onto the class prototype under
+ * the `FirestoreCollection` symbol.
+ *
+ * Mirrors `@dynamicTableName` in `@pristine-ts/aws`.
+ *
+ * @param name The container token whose value is the Firestore collection name.
+ */
+export declare const dynamicCollectionName: (name: string) => (constructor: any) => void;

package/dist/types/enums/cloud-storage-event-type.enum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Event types coming from GCP Cloud Storage object change events delivered via CloudEvents.
+ * CloudEvent `type` values map 1:1 with these enum values.
+ */
+export declare enum CloudStorageEventType {
+    UnknownCloudStorageEvent = "UnknownCloudStorageEvent",
+    ObjectFinalized = "google.cloud.storage.object.v1.finalized",
+    ObjectDeleted = "google.cloud.storage.object.v1.deleted",
+    ObjectArchived = "google.cloud.storage.object.v1.archived",
+    ObjectMetadataUpdated = "google.cloud.storage.object.v1.metadataUpdated"
+}

package/dist/types/enums/cloud-storage-presigned-operation-type.enum.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The operation a signed URL grants on a Cloud Storage object. Mirrors
+ * `S3PresignedOperationTypeEnum` in `@pristine-ts/aws`.
+ */
+export declare enum CloudStoragePresignedOperationTypeEnum {
+    Read = "read",
+    Write = "write"
+}

package/dist/types/enums/enums.d.ts

@@ -0,0 +1,5 @@
+export * from "./cloud-storage-event-type.enum";
+export * from "./cloud-storage-presigned-operation-type.enum";
+export * from "./eventarc-event-type.enum";
+export * from "./firestore-event-type.enum";
+export * from "./pub-sub-event-type.enum";

package/dist/types/enums/eventarc-event-type.enum.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Event types from Eventarc / generic CloudEvents that aren't claimed by a more
+ * specific mapper. The mapper falls through to `EventarcEvent`.
+ */
+export declare enum EventarcEventType {
+    EventarcEvent = "EVENTARC_EVENT"
+}

package/dist/types/enums/firestore-event-type.enum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Event types coming from GCP Firestore document change events delivered via CloudEvents.
+ * CloudEvent `type` values map 1:1 with these enum values.
+ */
+export declare enum FirestoreEventType {
+    UnknownFirestoreEvent = "UnknownFirestoreEvent",
+    DocumentCreated = "google.cloud.firestore.document.v1.created",
+    DocumentUpdated = "google.cloud.firestore.document.v1.updated",
+    DocumentDeleted = "google.cloud.firestore.document.v1.deleted",
+    DocumentWritten = "google.cloud.firestore.document.v1.written"
+}

package/dist/types/enums/pub-sub-event-type.enum.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Event types coming from GCP Pub/Sub. Pub/Sub itself only has one delivery shape
+ * (a message), so unlike S3 we don't enumerate sub-operations here.
+ */
+export declare enum PubSubEventType {
+    Message = "PUB_SUB_MESSAGE",
+    UnknownPubSubEvent = "UnknownPubSubEvent"
+}

package/dist/types/errors/errors.d.ts

@@ -0,0 +1,3 @@
+export * from "./eventarc-publish.error";
+export * from "./get-secret.error";
+export * from "./pub-sub-publish.error";

package/dist/types/errors/eventarc-publish.error.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Thrown by `EventarcClient` when publishing fails. Mirrors `EventBridgeSendMessageError`
+ * in `@pristine-ts/aws`.
+ */
+export declare class EventarcPublishError extends Error {
+    readonly cause: unknown;
+    constructor(cause: unknown);
+}

package/dist/types/errors/get-secret.error.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Thrown by `SecretManagerClient` when a secret retrieval fails (not found, missing
+ * payload, JSON parse error, missing key). Mirrors `GetSecretSecretsManagerError`
+ * in `@pristine-ts/aws`.
+ */
+export declare class GetSecretError extends Error {
+    constructor(message: string);
+}

package/dist/types/errors/pub-sub-publish.error.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Thrown by `PubSubClient` when publishing a message fails. Mirrors
+ * `SqsSendMessageError` in `@pristine-ts/aws`.
+ */
+export declare class PubSubPublishError extends Error {
+    readonly cause: unknown;
+    readonly topic: string;
+    readonly attributes?: {
+        [key: string]: string;
+    } | undefined;
+    constructor(cause: unknown, topic: string, attributes?: {
+        [key: string]: string;
+    } | undefined);
+}

package/dist/types/event-payloads/cloud-storage.event-payload.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The Pristine event payload for a parsed GCP Cloud Storage CloudEvent.
+ * Mirrors `S3EventPayload` in spirit.
+ */
+export declare class CloudStorageEventPayload {
+    /**
+     * The CloudEvent `type` (e.g. `google.cloud.storage.object.v1.finalized`).
+     */
+    eventType: string;
+    /**
+     * The CloudEvent `source` (e.g. `//storage.googleapis.com/projects/_/buckets/my-bucket`).
+     */
+    source: string;
+    /**
+     * The CloudEvent `time`, parsed.
+     */
+    eventTime?: Date;
+    /**
+     * The bucket name extracted from the event's `data` payload.
+     */
+    bucket: string;
+    /**
+     * The object name (path within the bucket).
+     */
+    name: string;
+    /**
+     * The generation number of the object.
+     */
+    generation?: string;
+    /**
+     * The metageneration number of the object.
+     */
+    metageneration?: string;
+    /**
+     * The MIME content type of the object.
+     */
+    contentType?: string;
+    /**
+     * The object size in bytes (as a string — Cloud Storage returns int64 as string).
+     */
+    size?: string;
+    /**
+     * The MD5 hash of the object (base64-encoded).
+     */
+    md5Hash?: string;
+    /**
+     * The CRC32C checksum of the object (base64-encoded).
+     */
+    crc32c?: string;
+    /**
+     * The raw `data` field from the CloudEvent — kept verbatim for consumers that need
+     * fields not promoted above.
+     */
+    data: any;
+}

package/dist/types/event-payloads/event-payloads.d.ts

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

package/dist/types/event-payloads/eventarc.event-payload.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The Pristine event payload for any CloudEvent that didn't match a more-specific
+ * mapper. Mirrors the role of `EventBridgePayload` for AWS.
+ */
+export declare class EventarcEventPayload {
+    /**
+     * CloudEvent `id`.
+     */
+    id: string;
+    /**
+     * CloudEvent `specversion`.
+     */
+    specVersion: string;
+    /**
+     * CloudEvent `type`.
+     */
+    type: string;
+    /**
+     * CloudEvent `source`.
+     */
+    source: string;
+    /**
+     * CloudEvent `subject`, if present.
+     */
+    subject?: string;
+    /**
+     * CloudEvent `time`, parsed if present.
+     */
+    time?: Date;
+    /**
+     * CloudEvent `datacontenttype`, if present.
+     */
+    dataContentType?: string;
+    /**
+     * The CloudEvent `data` payload, verbatim. Type-agnostic on purpose — this is the
+     * catch-all mapper.
+     */
+    data: any;
+}

package/dist/types/event-payloads/firestore.event-payload.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The Pristine event payload for a parsed GCP Firestore document-change CloudEvent.
+ * Mirrors `DynamodbEventPayload` in spirit.
+ */
+export declare class FirestoreEventPayload {
+    /**
+     * The CloudEvent `type` (e.g. `google.cloud.firestore.document.v1.created`).
+     */
+    eventType: string;
+    /**
+     * The CloudEvent `source` (e.g. `//firestore.googleapis.com/projects/p/databases/(default)`).
+     */
+    source: string;
+    /**
+     * The CloudEvent `time`, parsed.
+     */
+    eventTime?: Date;
+    /**
+     * The full document path that changed (e.g. `projects/p/databases/(default)/documents/users/abc`).
+     */
+    documentPath: string;
+    /**
+     * The Firestore document value after the change. Absent for `deleted` events.
+     * Keys are field names, values are Firestore-wire values (e.g. `{stringValue: "..."}`).
+     */
+    value?: {
+        [field: string]: any;
+    };
+    /**
+     * The document value before the change. Absent for `created` events.
+     */
+    oldValue?: {
+        [field: string]: any;
+    };
+    /**
+     * Field paths that changed (Firestore provides this only on `written`/`updated` events).
+     */
+    updateMask?: string[];
+    /**
+     * The raw `data` field from the CloudEvent — verbatim.
+     */
+    data: any;
+}

package/dist/types/event-payloads/pub-sub.event-payload.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The Pristine event payload for a parsed GCP Pub/Sub push-subscription delivery.
+ * Mirrors `SqsEventPayload` in shape: one payload per delivered message.
+ */
+export declare class PubSubEventPayload {
+    /**
+     * The Pub/Sub message ID assigned by GCP.
+     */
+    messageId: string;
+    /**
+     * The decoded message body. Pub/Sub delivers `data` as a base64 string; this is the
+     * decoded UTF-8 form. Consumers needing the raw bytes can use `rawData`.
+     */
+    body: string;
+    /**
+     * The raw base64-encoded `data` field exactly as Pub/Sub delivered it.
+     */
+    rawData: string;
+    /**
+     * User-defined string attributes attached to the message.
+     */
+    attributes: {
+        [key: string]: string;
+    };
+    /**
+     * The subscription this delivery is for, e.g. `projects/my-proj/subscriptions/my-sub`.
+     */
+    subscription: string;
+    /**
+     * The time the message was published to Pub/Sub.
+     */
+    publishTime?: Date;
+    /**
+     * For ordered delivery — the ordering key chosen by the publisher.
+     */
+    orderingKey?: string;
+}

package/dist/types/gcp.configuration-keys.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Typed configuration keys for `@pristine-ts/gcp`. Use these constants with `@injectConfig`
+ * for autocomplete + rename safety, instead of typing the parameter name as a string.
+ *
+ * ```ts
+ * import {injectConfig} from "@pristine-ts/common";
+ * import {GcpConfigurationKeys} from "@pristine-ts/gcp";
+ *
+ * constructor(@injectConfig(GcpConfigurationKeys.ProjectId) value: string) {}
+ * ```
+ */
+export declare const GcpConfigurationKeys: {
+    readonly ProjectId: "pristine.gcp.projectId";
+    readonly Region: "pristine.gcp.region";
+    readonly Credentials: "pristine.gcp.credentials";
+};
+/**
+ * The expected runtime types for each configuration value defined by `@pristine-ts/gcp`.
+ * See `AwsConfigurationValueMap` in `@pristine-ts/aws` for the full pattern + caveats.
+ */
+export interface GcpConfigurationValueMap {
+    "pristine.gcp.projectId": string;
+    "pristine.gcp.region": string;
+    "pristine.gcp.credentials": string;
+}
+/**
+ * Augments the global `PristineConfigurationValueMap` (defined in `@pristine-ts/common`)
+ * with this package's keys. The `@pristine-ts/eslint-plugin` rule
+ * `inject-config-type-match` reads the merged map to enforce parameter types on
+ * `@injectConfig` calls.
+ */
+declare module "@pristine-ts/common" {
+    interface PristineConfigurationValueMap extends GcpConfigurationValueMap {
+    }
+}

package/dist/types/gcp.module.d.ts

@@ -0,0 +1,11 @@
+import { ModuleInterface } from "@pristine-ts/common";
+export * from "./clients/clients";
+export * from "./enums/enums";
+export * from "./errors/errors";
+export * from "./event-payloads/event-payloads";
+export * from "./interfaces/interfaces";
+export * from "./mappers/mappers";
+export * from "./models/models";
+export * from "./gcp.module.keyname";
+export * from "./gcp.configuration-keys";
+export declare const GcpModule: ModuleInterface;

package/dist/types/gcp.module.keyname.d.ts

@@ -0,0 +1 @@
+export declare const GcpModuleKeyname: string;

package/dist/types/interfaces/client-options.interface.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Optional per-call options shared across all GCP clients. Mirrors `ClientOptionsInterface`
+ * in `@pristine-ts/aws`.
+ */
+export interface GcpClientOptionsInterface {
+    /**
+     * The per-request timeout in milliseconds. Forwarded to the underlying SDK when
+     * supported.
+     */
+    requestTimeout?: number;
+    /**
+     * The Pristine event id, threaded through for logging/tracing correlation.
+     */
+    eventId?: string;
+    /**
+     * The Pristine event group id, threaded through for logging/tracing correlation.
+     */
+    eventGroupId?: string;
+}

package/dist/types/interfaces/cloud-storage-client.interface.d.ts

@@ -0,0 +1,14 @@
+import { Storage } from "@google-cloud/storage";
+import { Readable } from "stream";
+import { CloudStoragePresignedOperationTypeEnum } from "../enums/cloud-storage-presigned-operation-type.enum";
+import { GcpClientOptionsInterface } from "./client-options.interface";
+export interface CloudStorageClientInterface {
+    getClient(): Storage;
+    get(bucketName: string, key: string, options?: Partial<GcpClientOptionsInterface>): Promise<Buffer>;
+    getObjectBodyAsArrayBuffer(bucketName: string, key: string, options?: Partial<GcpClientOptionsInterface>): Promise<ArrayBuffer>;
+    listKeys(bucketName: string, prefix?: string, options?: Partial<GcpClientOptionsInterface>): Promise<string[]>;
+    upload(bucketName: string, key: string, data: Buffer | string | Readable, contentType?: string, contentEncoding?: string, options?: Partial<GcpClientOptionsInterface>): Promise<void>;
+    download(bucketName: string, key: string, options?: Partial<GcpClientOptionsInterface>): Promise<Readable>;
+    deleteObject(bucketName: string, key: string, options?: Partial<GcpClientOptionsInterface>): Promise<void>;
+    createSignedUrl(bucketName: string, key: string, operation: CloudStoragePresignedOperationTypeEnum, expiresInSeconds?: number): Promise<string>;
+}

package/dist/types/interfaces/eventarc-client.interface.d.ts

@@ -0,0 +1,5 @@
+import { EventarcMessageModel } from "../models/eventarc-message.model";
+import { GcpClientOptionsInterface } from "./client-options.interface";
+export interface EventarcClientInterface {
+    publish(events: EventarcMessageModel | EventarcMessageModel[], channel?: string, options?: Partial<GcpClientOptionsInterface>): Promise<void>;
+}

package/dist/types/interfaces/firestore-client.interface.d.ts

@@ -0,0 +1,27 @@
+import { Firestore } from "@google-cloud/firestore";
+/**
+ * Tag-injection contract for `FirestoreClient`. Inject by string token `"FirestoreClientInterface"`.
+ */
+export interface FirestoreClientInterface {
+    getClient(): Firestore;
+    get<T>(classType: {
+        new (): T;
+    }, id: string): Promise<T | undefined>;
+    list<T>(classType: {
+        new (): T;
+    }, options?: {
+        limit?: number;
+        startAfter?: any;
+    }): Promise<T[]>;
+    create<T>(item: T): Promise<T>;
+    update<T>(item: T): Promise<T>;
+    save<T>(item: T): Promise<T>;
+    delete<T>(classType: {
+        new (): T;
+    }, id: string): Promise<void>;
+    findBySecondaryIndex<T>(classType: {
+        new (): T;
+    }, field: string, value: any, options?: {
+        limit?: number;
+    }): Promise<T[]>;
+}

package/dist/types/interfaces/interfaces.d.ts

@@ -0,0 +1,6 @@
+export * from "./client-options.interface";
+export * from "./cloud-storage-client.interface";
+export * from "./eventarc-client.interface";
+export * from "./firestore-client.interface";
+export * from "./pub-sub-client.interface";
+export * from "./secret-manager-client.interface";

package/dist/types/interfaces/pub-sub-client.interface.d.ts

@@ -0,0 +1,8 @@
+import { PubSub } from "@google-cloud/pubsub";
+import { PubSubMessageModel } from "../models/pub-sub-message.model";
+import { PubSubMessageSentConfirmationModel } from "../models/pub-sub-message-sent-confirmation.model";
+import { GcpClientOptionsInterface } from "./client-options.interface";
+export interface PubSubClientInterface {
+    getClient(): PubSub;
+    publish(topic: string, message: PubSubMessageModel, options?: Partial<GcpClientOptionsInterface>): Promise<PubSubMessageSentConfirmationModel>;
+}

package/dist/types/interfaces/secret-manager-client.interface.d.ts

@@ -0,0 +1,9 @@
+import { SecretManagerServiceClient } from "@google-cloud/secret-manager";
+import { GcpClientOptionsInterface } from "./client-options.interface";
+export interface SecretManagerClientInterface {
+    getClient(): SecretManagerServiceClient;
+    getSecret(secretName: string, options?: Partial<GcpClientOptionsInterface>): Promise<{
+        [key: string]: string;
+    }>;
+    getSecretKey(secretName: string, key: string, options?: Partial<GcpClientOptionsInterface>): Promise<string>;
+}

package/dist/types/mappers/cloud-storage-event.mapper.d.ts

@@ -0,0 +1,22 @@
+import { EventIdManager, EventMapperInterface, EventResponse, EventsExecutionOptionsInterface, ExecutionContextInterface } from "@pristine-ts/core";
+import { CloudStorageEventPayload } from "../event-payloads/cloud-storage.event-payload";
+/**
+ * Maps a GCP Cloud Storage CloudEvent into a Pristine `Event<CloudStorageEventPayload>`.
+ *
+ * The raw event can arrive in two shapes:
+ *   1. Structured CloudEvent (`{specversion, id, type, source, data, ...}`) — when an
+ *      Eventarc trigger or Gen 2 Cloud Function delivers it via HTTP body.
+ *   2. Pre-parsed shape from the entry-point shim with the same fields at the top
+ *      level. Both are supported.
+ *
+ * Detection: the CloudEvent `type` starts with `google.cloud.storage.object.v1.`.
+ */
+export declare class CloudStorageEventMapper implements EventMapperInterface<CloudStorageEventPayload, void> {
+    private readonly eventIdManager;
+    constructor(eventIdManager: EventIdManager);
+    supportsMapping(rawEvent: any, executionContext: ExecutionContextInterface<any>): boolean;
+    map(rawEvent: any, executionContext: ExecutionContextInterface<any>): EventsExecutionOptionsInterface<CloudStorageEventPayload>;
+    supportsReverseMapping(eventResponse: EventResponse<CloudStorageEventPayload, void>, response: any, executionContext: ExecutionContextInterface<any>): boolean;
+    reverseMap(eventResponse: EventResponse<CloudStorageEventPayload, void>, response: any, executionContext: ExecutionContextInterface<any>): void;
+    private findEnum;
+}