@hazeljs/pubsub 0.7.7

package/dist/pubsub-subscriber.service.d.ts

@@ -0,0 +1,15 @@
+import type { PubSub } from '@google-cloud/pubsub';
+export declare class PubSubSubscriberService {
+    private readonly pubsub;
+    private runningSubscriptions;
+    constructor(pubsub: PubSub);
+    registerFromProvider(provider: object): Promise<void>;
+    private registerSubscription;
+    private mergeOptions;
+    private resolveSubscription;
+    private handleMessage;
+    private parseData;
+    onModuleDestroy(): Promise<void>;
+    getSubscriptionCount(): number;
+}
+//# sourceMappingURL=pubsub-subscriber.service.d.ts.map

package/dist/pubsub-subscriber.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub-subscriber.service.d.ts","sourceRoot":"","sources":["../src/pubsub-subscriber.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,MAAM,EAAgB,MAAM,sBAAsB,CAAC;AAmB1E,qBACa,uBAAuB;IAKhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,oBAAoB,CAA6B;gBAItC,MAAM,EAAE,MAAM;IAG3B,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAuB7C,oBAAoB;IAiDlC,OAAO,CAAC,YAAY;YAmBN,mBAAmB;YAwBnB,aAAa;IAyC3B,OAAO,CAAC,SAAS;IAUX,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IActC,oBAAoB,IAAI,MAAM;CAG/B"}

package/dist/pubsub-subscriber.service.js

@@ -0,0 +1,153 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PubSubSubscriberService = void 0;
+const core_1 = require("@hazeljs/core");
+const pubsub_consumer_decorator_1 = require("./decorators/pubsub-consumer.decorator");
+const pubsub_subscribe_decorator_1 = require("./decorators/pubsub-subscribe.decorator");
+const core_2 = __importDefault(require("@hazeljs/core"));
+const pubsub_publisher_service_1 = require("./pubsub-publisher.service");
+let PubSubSubscriberService = class PubSubSubscriberService {
+    constructor(pubsub) {
+        this.pubsub = pubsub;
+        this.runningSubscriptions = [];
+    }
+    async registerFromProvider(provider) {
+        const consumerOptions = (0, pubsub_consumer_decorator_1.getPubSubConsumerMetadata)(provider.constructor);
+        const subscribeMetadata = (0, pubsub_subscribe_decorator_1.getPubSubSubscribeMetadata)(provider.constructor);
+        if (!consumerOptions) {
+            core_2.default.warn(`Provider ${provider.constructor.name} has @PubSubSubscribe but no @PubSubConsumer decorator - skipping`);
+            return;
+        }
+        if (!subscribeMetadata.length) {
+            core_2.default.warn(`Provider ${provider.constructor.name} has @PubSubConsumer but no @PubSubSubscribe - skipping`);
+            return;
+        }
+        for (const metadata of subscribeMetadata) {
+            await this.registerSubscription(provider, metadata, consumerOptions);
+        }
+    }
+    async registerSubscription(provider, metadata, consumerDefaults) {
+        const method = provider[metadata.methodName];
+        if (typeof method !== 'function') {
+            core_2.default.error(`Handler ${metadata.methodName} not found on ${provider.constructor.name}`);
+            return;
+        }
+        const options = this.mergeOptions(consumerDefaults, metadata.options);
+        const subscription = await this.resolveSubscription(options);
+        const handler = async (message) => {
+            await this.handleMessage(provider, method, options, message);
+        };
+        subscription.on('message', handler);
+        subscription.on('error', (error) => {
+            core_2.default.error(`Pub/Sub subscription error on ${provider.constructor.name}.${metadata.methodName}:`, error);
+        });
+        this.runningSubscriptions.push({
+            provider,
+            subscriptionName: options.subscription,
+            subscription,
+            handler,
+        });
+        core_2.default.info(`Pub/Sub subscription started for ${provider.constructor.name}.${metadata.methodName} (${options.subscription})`);
+    }
+    mergeOptions(consumerDefaults, methodOptions) {
+        return {
+            ...methodOptions,
+            parseJson: methodOptions.parseJson ?? consumerDefaults.parseJson ?? true,
+            ackOnSuccess: methodOptions.ackOnSuccess ?? consumerDefaults.ackOnSuccess ?? true,
+            nackOnError: methodOptions.nackOnError ?? consumerDefaults.nackOnError ?? true,
+            autoCreateSubscription: methodOptions.autoCreateSubscription ?? consumerDefaults.autoCreateSubscription ?? false,
+        };
+    }
+    async resolveSubscription(options) {
+        const subscription = this.pubsub.subscription(options.subscription);
+        if (!options.autoCreateSubscription) {
+            return subscription;
+        }
+        const [exists] = await subscription.exists();
+        if (exists)
+            return subscription;
+        if (!options.topic) {
+            throw new Error(`Cannot auto-create subscription "${options.subscription}" without a topic. Add topic to @PubSubSubscribe options.`);
+        }
+        const topic = this.pubsub.topic(options.topic);
+        await topic.createSubscription(options.subscription);
+        core_2.default.info(`Auto-created Pub/Sub subscription "${options.subscription}" for topic "${options.topic}"`);
+        return this.pubsub.subscription(options.subscription);
+    }
+    async handleMessage(provider, method, options, message) {
+        const rawData = message.data;
+        const parsed = this.parseData(rawData, options.parseJson ?? true);
+        const payload = {
+            data: parsed,
+            rawData,
+            attributes: message.attributes ?? {},
+            id: message.id,
+            orderingKey: message.orderingKey,
+            publishTime: message.publishTime ? new Date(message.publishTime) : undefined,
+            ack: () => message.ack(),
+            nack: () => message.nack(),
+        };
+        try {
+            const result = await method.call(provider, payload);
+            if (result === 'nack') {
+                message.nack();
+                return;
+            }
+            if (result === 'ack' || options.ackOnSuccess) {
+                message.ack();
+            }
+        }
+        catch (error) {
+            core_2.default.error(`Error in Pub/Sub handler ${provider.constructor.name}.${method.name || 'anonymous'}:`, error);
+            if (options.nackOnError) {
+                message.nack();
+            }
+        }
+    }
+    parseData(data, parseJson) {
+        const content = data.toString();
+        if (!parseJson)
+            return content;
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            return content;
+        }
+    }
+    async onModuleDestroy() {
+        for (const item of this.runningSubscriptions) {
+            try {
+                item.subscription.removeListener('message', item.handler);
+            }
+            catch (error) {
+                core_2.default.error(`Failed removing Pub/Sub listener (${item.provider.constructor.name}, ${item.subscriptionName}):`, error);
+            }
+        }
+        this.runningSubscriptions = [];
+    }
+    getSubscriptionCount() {
+        return this.runningSubscriptions.length;
+    }
+};
+exports.PubSubSubscriberService = PubSubSubscriberService;
+exports.PubSubSubscriberService = PubSubSubscriberService = __decorate([
+    (0, core_1.Service)(),
+    __param(0, (0, core_1.Inject)(pubsub_publisher_service_1.PUBSUB_CLIENT_TOKEN)),
+    __metadata("design:paramtypes", [Function])
+], PubSubSubscriberService);

package/dist/pubsub.module.d.ts

@@ -0,0 +1,10 @@
+import { PubSubModuleOptions } from './pubsub.types';
+export declare class PubSubModule {
+    static forRoot(options?: PubSubModuleOptions): typeof PubSubModule;
+    static forRootAsync(options: {
+        useFactory: (...args: unknown[]) => Promise<PubSubModuleOptions> | PubSubModuleOptions;
+        inject?: unknown[];
+    }): Promise<typeof PubSubModule>;
+    static registerSubscriptionsFromProvider(provider: object): Promise<void>;
+}
+//# sourceMappingURL=pubsub.module.d.ts.map

package/dist/pubsub.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.module.d.ts","sourceRoot":"","sources":["../src/pubsub.module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAKrD,qBAIa,YAAY;IACvB,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,YAAY;WAazD,YAAY,CAAC,OAAO,EAAE;QACjC,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,CAAC;QACvF,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;KACpB,GAAG,OAAO,CAAC,OAAO,YAAY,CAAC;WAkBnB,iCAAiC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBhF"}

package/dist/pubsub.module.js

@@ -0,0 +1,65 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var PubSubModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PubSubModule = void 0;
+const core_1 = require("@hazeljs/core");
+const pubsub_1 = require("@google-cloud/pubsub");
+const pubsub_publisher_service_1 = require("./pubsub-publisher.service");
+const pubsub_subscriber_service_1 = require("./pubsub-subscriber.service");
+const core_2 = __importDefault(require("@hazeljs/core"));
+let PubSubModule = PubSubModule_1 = class PubSubModule {
+    static forRoot(options = {}) {
+        core_2.default.info('Configuring Pub/Sub module...');
+        const pubsubClient = new pubsub_1.PubSub({
+            projectId: options.projectId,
+            keyFilename: options.keyFilename,
+            apiEndpoint: options.apiEndpoint,
+        });
+        core_1.Container.getInstance().register(pubsub_publisher_service_1.PUBSUB_CLIENT_TOKEN, pubsubClient);
+        return PubSubModule_1;
+    }
+    static async forRootAsync(options) {
+        const container = core_1.Container.getInstance();
+        const injectTokens = options.inject ?? [];
+        const deps = injectTokens.map((token) => container.resolve(token));
+        const pubsubOptions = await Promise.resolve(options.useFactory(...deps));
+        const pubsubClient = new pubsub_1.PubSub({
+            projectId: pubsubOptions.projectId,
+            keyFilename: pubsubOptions.keyFilename,
+            apiEndpoint: pubsubOptions.apiEndpoint,
+        });
+        container.register(pubsub_publisher_service_1.PUBSUB_CLIENT_TOKEN, pubsubClient);
+        return PubSubModule_1;
+    }
+    static async registerSubscriptionsFromProvider(provider) {
+        try {
+            const container = core_1.Container.getInstance();
+            const subscriberService = container.resolve(pubsub_subscriber_service_1.PubSubSubscriberService);
+            if (!subscriberService) {
+                core_2.default.warn('PubSubSubscriberService not found in DI container');
+                return;
+            }
+            await subscriberService.registerFromProvider(provider);
+            core_2.default.info(`Registered Pub/Sub subscriptions from provider: ${provider.constructor.name}`);
+        }
+        catch (error) {
+            core_2.default.error('Error registering Pub/Sub subscriptions from provider:', error);
+        }
+    }
+};
+exports.PubSubModule = PubSubModule;
+exports.PubSubModule = PubSubModule = PubSubModule_1 = __decorate([
+    (0, core_1.HazelModule)({
+        providers: [pubsub_publisher_service_1.PubSubPublisherService, pubsub_subscriber_service_1.PubSubSubscriberService],
+        exports: [pubsub_publisher_service_1.PubSubPublisherService, pubsub_subscriber_service_1.PubSubSubscriberService],
+    })
+], PubSubModule);

package/dist/pubsub.types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Pub/Sub module types and interfaces
+ */
+export interface PubSubClientOptions {
+    projectId?: string;
+    keyFilename?: string;
+    apiEndpoint?: string;
+}
+export interface PubSubModuleOptions extends PubSubClientOptions {
+    /**
+     * Whether this is a global module.
+     * @default true
+     */
+    isGlobal?: boolean;
+}
+export interface PubSubPublishOptions {
+    attributes?: Record<string, string>;
+    orderingKey?: string;
+}
+export interface PubSubSubscribeOptions {
+    subscription: string;
+    topic?: string;
+    autoCreateSubscription?: boolean;
+    ackOnSuccess?: boolean;
+    nackOnError?: boolean;
+    parseJson?: boolean;
+}
+export interface PubSubConsumerOptions {
+    ackOnSuccess?: boolean;
+    nackOnError?: boolean;
+    parseJson?: boolean;
+    autoCreateSubscription?: boolean;
+}
+export interface PubSubSubscribeMetadata {
+    methodName: string;
+    options: PubSubSubscribeOptions;
+}
+export interface PubSubSubscriptionHandlerPayload<T = unknown> {
+    data: T;
+    rawData: Buffer;
+    attributes: Record<string, string>;
+    id: string;
+    orderingKey?: string;
+    publishTime?: Date;
+    ack: () => void;
+    nack: () => void;
+}
+export type PubSubHandlerResult = void | 'ack' | 'nack';
+//# sourceMappingURL=pubsub.types.d.ts.map

package/dist/pubsub.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.types.d.ts","sourceRoot":"","sources":["../src/pubsub.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED,MAAM,WAAW,gCAAgC,CAAC,CAAC,GAAG,OAAO;IAC3D,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC"}

package/dist/pubsub.types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Pub/Sub module types and interfaces
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@hazeljs/pubsub",
+  "version": "0.7.7",
+  "description": "Google Cloud Pub/Sub module for HazelJS framework with decorator-based consumers",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest --coverage",
+    "lint": "eslint \"src/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@google-cloud/pubsub": "^4.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.39",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
+    "eslint": "^8.57.1",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.9",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hazel-js/hazeljs.git",
+    "directory": "packages/pubsub"
+  },
+  "keywords": [
+    "hazeljs",
+    "google-pubsub",
+    "pubsub",
+    "messaging",
+    "event-driven"
+  ],
+  "author": "Muhammad Arslan <muhammad.arslan@hazeljs.ai>",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/hazeljs/hazel-js/issues"
+  },
+  "homepage": "https://hazeljs.ai",
+  "peerDependencies": {
+    "@hazeljs/core": ">=0.2.0-beta.0"
+  },
+  "gitHead": "5fa18729312dd9d2abe5dee3801fbd0ac0f1c3c9"
+}