@wenlarge/ostrol-communication 0.5.0

package/dist/generated/google/protobuf/struct.d.ts

@@ -0,0 +1,82 @@
+export declare const protobufPackage = "google.protobuf";
+/**
+ * `NullValue` is a singleton enumeration to represent the null value for the
+ * `Value` type union.
+ *
+ *  The JSON representation for `NullValue` is JSON `null`.
+ */
+export declare enum NullValue {
+    /** NULL_VALUE - Null value. */
+    NULL_VALUE = "NULL_VALUE",
+    UNRECOGNIZED = "UNRECOGNIZED"
+}
+/**
+ * `Struct` represents a structured data value, consisting of fields
+ * which map to dynamically typed values. In some languages, `Struct`
+ * might be supported by a native representation. For example, in
+ * scripting languages like JS a struct is represented as an
+ * object. The details of that representation are described together
+ * with the proto support for the language.
+ *
+ * The JSON representation for `Struct` is JSON object.
+ */
+export interface Struct {
+    /** Unordered map of dynamically typed values. */
+    fields: {
+        [key: string]: any | undefined;
+    };
+}
+export interface Struct_FieldsEntry {
+    key: string;
+    value?: any | undefined;
+}
+/**
+ * `Value` represents a dynamically typed value which can be either
+ * null, a number, a string, a boolean, a recursive struct value, or a
+ * list of values. A producer of value is expected to set one of these
+ * variants. Absence of any variant indicates an error.
+ *
+ * The JSON representation for `Value` is JSON value.
+ */
+export interface Value {
+    /** Represents a null value. */
+    nullValue?: NullValue | undefined;
+    /** Represents a double value. */
+    numberValue?: number | undefined;
+    /** Represents a string value. */
+    stringValue?: string | undefined;
+    /** Represents a boolean value. */
+    boolValue?: boolean | undefined;
+    /** Represents a structured value. */
+    structValue?: {
+        [key: string]: any;
+    } | undefined;
+    /** Represents a repeated `Value`. */
+    listValue?: Array<any> | undefined;
+}
+/**
+ * `ListValue` is a wrapper around a repeated field of values.
+ *
+ * The JSON representation for `ListValue` is JSON array.
+ */
+export interface ListValue {
+    /** Repeated field of dynamically typed values. */
+    values: any[];
+}
+export declare const GOOGLE_PROTOBUF_PACKAGE_NAME = "google.protobuf";
+export declare const Struct: {
+    wrap(object: {
+        [key: string]: any;
+    } | undefined): Struct;
+    unwrap(message: Struct): {
+        [key: string]: any;
+    };
+};
+export declare const Value: {
+    wrap(value: any): Value;
+    unwrap(message: any): string | number | boolean | Object | null | Array<any> | undefined;
+};
+export declare const ListValue: {
+    wrap(array: Array<any> | undefined): ListValue;
+    unwrap(message: ListValue): Array<any>;
+};

package/dist/generated/google/protobuf/struct.js

@@ -0,0 +1,117 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v1.181.2
+//   protoc               v3.21.5
+// source: google/protobuf/struct.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListValue = exports.Value = exports.Struct = exports.GOOGLE_PROTOBUF_PACKAGE_NAME = exports.NullValue = exports.protobufPackage = void 0;
+/* eslint-disable */
+const protobufjs_1 = require("protobufjs");
+exports.protobufPackage = "google.protobuf";
+/**
+ * `NullValue` is a singleton enumeration to represent the null value for the
+ * `Value` type union.
+ *
+ *  The JSON representation for `NullValue` is JSON `null`.
+ */
+var NullValue;
+(function (NullValue) {
+    /** NULL_VALUE - Null value. */
+    NullValue["NULL_VALUE"] = "NULL_VALUE";
+    NullValue["UNRECOGNIZED"] = "UNRECOGNIZED";
+})(NullValue || (exports.NullValue = NullValue = {}));
+exports.GOOGLE_PROTOBUF_PACKAGE_NAME = "google.protobuf";
+function createBaseStruct() {
+    return { fields: {} };
+}
+exports.Struct = {
+    wrap(object) {
+        const struct = createBaseStruct();
+        if (object !== undefined) {
+            for (const key of Object.keys(object)) {
+                struct.fields[key] = exports.Value.wrap(object[key]);
+            }
+        }
+        return struct;
+    },
+    unwrap(message) {
+        const object = {};
+        if (message.fields) {
+            for (const key of Object.keys(message.fields)) {
+                object[key] = exports.Value.unwrap(message.fields[key]);
+            }
+        }
+        return object;
+    },
+};
+function createBaseValue() {
+    return {};
+}
+exports.Value = {
+    wrap(value) {
+        const result = {};
+        if (value === null) {
+            result.nullValue = NullValue.NULL_VALUE;
+        }
+        else if (typeof value === "boolean") {
+            result.boolValue = value;
+        }
+        else if (typeof value === "number") {
+            result.numberValue = value;
+        }
+        else if (typeof value === "string") {
+            result.stringValue = value;
+        }
+        else if (globalThis.Array.isArray(value)) {
+            result.listValue = exports.ListValue.wrap(value);
+        }
+        else if (typeof value === "object") {
+            result.structValue = exports.Struct.wrap(value);
+        }
+        else if (typeof value !== "undefined") {
+            throw new globalThis.Error("Unsupported any value type: " + typeof value);
+        }
+        return result;
+    },
+    unwrap(message) {
+        if (message?.hasOwnProperty("stringValue") && message.stringValue !== undefined) {
+            return message.stringValue;
+        }
+        else if (message?.hasOwnProperty("numberValue") && message?.numberValue !== undefined) {
+            return message.numberValue;
+        }
+        else if (message?.hasOwnProperty("boolValue") && message?.boolValue !== undefined) {
+            return message.boolValue;
+        }
+        else if (message?.hasOwnProperty("structValue") && message?.structValue !== undefined) {
+            return exports.Struct.unwrap(message.structValue);
+        }
+        else if (message?.hasOwnProperty("listValue") && message?.listValue !== undefined) {
+            return exports.ListValue.unwrap(message.listValue);
+        }
+        else if (message?.hasOwnProperty("nullValue") && message?.nullValue !== undefined) {
+            return null;
+        }
+        return undefined;
+    },
+};
+function createBaseListValue() {
+    return { values: [] };
+}
+exports.ListValue = {
+    wrap(array) {
+        const result = createBaseListValue();
+        result.values = (array ?? []).map(exports.Value.wrap);
+        return result;
+    },
+    unwrap(message) {
+        if (message?.hasOwnProperty("values") && globalThis.Array.isArray(message.values)) {
+            return message.values.map(exports.Value.unwrap);
+        }
+        else {
+            return message;
+        }
+    },
+};
+protobufjs_1.wrappers[".google.protobuf.Struct"] = { fromObject: exports.Struct.wrap, toObject: exports.Struct.unwrap };

package/dist/grpc-client/grpc-client.module.d.ts

@@ -0,0 +1,10 @@
+import { DynamicModule } from "@nestjs/common";
+export interface GrpcClientModuleOptions {
+    authServiceUrl?: string;
+    astrologyServiceUrl?: string;
+    billingServiceUrl?: string;
+    astroEngineServiceUrl?: string;
+}
+export declare class GrpcClientModule {
+    static forRoot(options: GrpcClientModuleOptions): DynamicModule;
+}

package/dist/grpc-client/grpc-client.module.js

@@ -0,0 +1,68 @@
+"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 GrpcClientModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrpcClientModule = void 0;
+const common_1 = require("@nestjs/common");
+const microservices_1 = require("@nestjs/microservices");
+const path_1 = require("path");
+const auth_1 = require("../generated/auth");
+const astrology_1 = require("../generated/astrology");
+const billing_1 = require("../generated/billing");
+const astro_engine_1 = require("../generated/astro_engine");
+const auth_config_1 = require("../config/auth-config");
+const astrology_config_1 = require("../config/astrology-config");
+const billing_config_1 = require("../config/billing-config");
+const astro_engine_config_1 = require("../config/astro-engine-config");
+// proto/ is shipped at the package root; from dist/grpc-client that is ../../proto.
+const PROTO_DIR = (0, path_1.join)(__dirname, "../../proto");
+const loaderOptions = {
+    keepCase: true,
+    longs: String,
+    enums: String,
+    defaults: true,
+    oneofs: true,
+    includeDirs: [PROTO_DIR], // resolves `import "common.proto"`
+};
+const grpcClient = (name, pkg, protoPaths, url) => ({
+    name,
+    transport: microservices_1.Transport.GRPC,
+    options: {
+        package: pkg,
+        protoPath: protoPaths.map((p) => (0, path_1.join)(__dirname, "../../" + p)),
+        url,
+        loader: loaderOptions,
+    },
+});
+let GrpcClientModule = GrpcClientModule_1 = class GrpcClientModule {
+    static forRoot(options) {
+        const clients = [];
+        if (options.authServiceUrl) {
+            clients.push(grpcClient(auth_1.AUTH_SERVICE_NAME, auth_1.AUTH_PACKAGE_NAME, auth_config_1.AUTH_PROTO_PATH, options.authServiceUrl));
+        }
+        if (options.astrologyServiceUrl) {
+            clients.push(grpcClient(astrology_1.ASTROLOGY_SERVICE_NAME, astrology_1.ASTROLOGY_PACKAGE_NAME, astrology_config_1.ASTROLOGY_PROTO_PATH, options.astrologyServiceUrl));
+        }
+        if (options.billingServiceUrl) {
+            clients.push(grpcClient(billing_1.BILLING_SERVICE_NAME, billing_1.BILLING_PACKAGE_NAME, billing_config_1.BILLING_PROTO_PATH, options.billingServiceUrl));
+        }
+        if (options.astroEngineServiceUrl) {
+            clients.push(grpcClient(astro_engine_1.ASTRO_ENGINE_SERVICE_NAME, astro_engine_1.ASTRO_ENGINE_PACKAGE_NAME, astro_engine_config_1.ASTRO_ENGINE_PROTO_PATH, options.astroEngineServiceUrl));
+        }
+        return {
+            module: GrpcClientModule_1,
+            global: true,
+            imports: [microservices_1.ClientsModule.register(clients)],
+            exports: [microservices_1.ClientsModule],
+        };
+    }
+};
+exports.GrpcClientModule = GrpcClientModule;
+exports.GrpcClientModule = GrpcClientModule = GrpcClientModule_1 = __decorate([
+    (0, common_1.Module)({})
+], GrpcClientModule);

package/dist/grpc-client/index.d.ts

@@ -0,0 +1 @@
+export * from "./grpc-client.module";

package/dist/grpc-client/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./grpc-client.module"), exports);

package/dist/helpers/helper.d.ts

@@ -0,0 +1,12 @@
+import { Metadata } from "@grpc/grpc-js";
+import type { PlanString } from "../kafka/payloads";
+export declare const USER_METADATA_KEY = "user";
+export declare const REQUEST_ID_METADATA_KEY = "x-request-id";
+export interface UserContext {
+    userId: string;
+    plan: PlanString;
+    language?: string;
+    email?: string;
+}
+export declare function parseUserFromMetadata(metadata: Metadata): UserContext | null;
+export declare function buildUserMetadata(user: UserContext, requestId?: string): Metadata;

package/dist/helpers/helper.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REQUEST_ID_METADATA_KEY = exports.USER_METADATA_KEY = void 0;
+exports.parseUserFromMetadata = parseUserFromMetadata;
+exports.buildUserMetadata = buildUserMetadata;
+const grpc_js_1 = require("@grpc/grpc-js");
+exports.USER_METADATA_KEY = "user";
+exports.REQUEST_ID_METADATA_KEY = "x-request-id";
+// Reads + decodes the base64 JSON `user` metadata blob. Returns null when absent
+// or malformed (e.g. a public/unauthenticated route).
+function parseUserFromMetadata(metadata) {
+    const raw = metadata.get(exports.USER_METADATA_KEY)[0];
+    if (!raw || typeof raw !== "string")
+        return null;
+    try {
+        const decoded = Buffer.from(raw, "base64").toString("utf8");
+        return JSON.parse(decoded);
+    }
+    catch {
+        return null;
+    }
+}
+// Builds gRPC metadata carrying the user context (and optional request id). Used by
+// the gateway's client layer to forward auth context downstream.
+function buildUserMetadata(user, requestId) {
+    const metadata = new grpc_js_1.Metadata();
+    metadata.set(exports.USER_METADATA_KEY, Buffer.from(JSON.stringify(user), "utf8").toString("base64"));
+    if (requestId)
+        metadata.set(exports.REQUEST_ID_METADATA_KEY, requestId);
+    return metadata;
+}

package/dist/helpers/struct-to-json.d.ts

@@ -0,0 +1,3 @@
+import { Struct } from "../generated/google/protobuf/struct";
+export declare function wrapStruct(obj: Record<string, any> | null | undefined): Struct | undefined;
+export declare function unwrapStruct(struct: Struct | Record<string, any> | null | undefined): Record<string, any> | undefined;

package/dist/helpers/struct-to-json.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapStruct = wrapStruct;
+exports.unwrapStruct = unwrapStruct;
+const struct_1 = require("../generated/google/protobuf/struct");
+// Wrap a plain JS object into a protobuf Struct for fields typed as
+// google.protobuf.Struct (e.g. NatalChart.rawData, astro-engine outputs).
+function wrapStruct(obj) {
+    if (obj == null)
+        return undefined;
+    return struct_1.Struct.wrap(obj);
+}
+// Unwrap a protobuf Struct (or its `.fields`) back into a plain JS object.
+function unwrapStruct(struct) {
+    if (struct == null)
+        return undefined;
+    const fields = "fields" in struct ? struct.fields : struct;
+    if (fields == null)
+        return undefined;
+    const result = {};
+    for (const key in fields) {
+        const value = fields[key];
+        if (value == null) {
+            result[key] = null;
+        }
+        else if ("stringValue" in value) {
+            result[key] = value.stringValue;
+        }
+        else if ("numberValue" in value) {
+            result[key] = value.numberValue;
+        }
+        else if ("boolValue" in value) {
+            result[key] = value.boolValue;
+        }
+        else if ("structValue" in value) {
+            result[key] = unwrapStruct(value.structValue?.fields ?? {});
+        }
+        else if ("listValue" in value) {
+            result[key] = value.listValue?.values?.map((v) => unwrapStruct({ tmp: v })?.tmp);
+        }
+        else {
+            result[key] = null;
+        }
+    }
+    return result;
+}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export * as Common from "./generated/common";
+export * as Auth from "./generated/auth";
+export * as Astrology from "./generated/astrology";
+export * as Billing from "./generated/billing";
+export * as AstroEngine from "./generated/astro_engine";
+export * from "./config/auth-config";
+export * from "./config/astrology-config";
+export * from "./config/billing-config";
+export * from "./config/astro-engine-config";
+export * from "./grpc-client";
+export * from "./kafka/kafka-topics";
+export * from "./kafka/payloads";
+export * from "./kafka/commit-kafka-offset";
+export * from "./helpers/helper";
+export * from "./helpers/struct-to-json";
+export * from "./pagination/cursor";
+export { Metadata } from "@grpc/grpc-js";
+export { Struct, Value, ListValue } from "./generated/google/protobuf/struct";

package/dist/index.js

@@ -0,0 +1,69 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListValue = exports.Value = exports.Struct = exports.Metadata = exports.AstroEngine = exports.Billing = exports.Astrology = exports.Auth = exports.Common = void 0;
+// Generated gRPC types are namespaced to avoid cross-proto name collisions
+// (e.g. each package's enums/messages live under their own namespace).
+exports.Common = __importStar(require("./generated/common"));
+exports.Auth = __importStar(require("./generated/auth"));
+exports.Astrology = __importStar(require("./generated/astrology"));
+exports.Billing = __importStar(require("./generated/billing"));
+exports.AstroEngine = __importStar(require("./generated/astro_engine"));
+// proto path config (consumed by GrpcClientModule + service main bootstrap)
+__exportStar(require("./config/auth-config"), exports);
+__exportStar(require("./config/astrology-config"), exports);
+__exportStar(require("./config/billing-config"), exports);
+__exportStar(require("./config/astro-engine-config"), exports);
+// gRPC client dynamic module
+__exportStar(require("./grpc-client"), exports);
+// Kafka
+__exportStar(require("./kafka/kafka-topics"), exports);
+__exportStar(require("./kafka/payloads"), exports);
+__exportStar(require("./kafka/commit-kafka-offset"), exports);
+// helpers
+__exportStar(require("./helpers/helper"), exports);
+__exportStar(require("./helpers/struct-to-json"), exports);
+// pagination
+__exportStar(require("./pagination/cursor"), exports);
+// re-exports for convenience
+var grpc_js_1 = require("@grpc/grpc-js");
+Object.defineProperty(exports, "Metadata", { enumerable: true, get: function () { return grpc_js_1.Metadata; } });
+var struct_1 = require("./generated/google/protobuf/struct");
+Object.defineProperty(exports, "Struct", { enumerable: true, get: function () { return struct_1.Struct; } });
+Object.defineProperty(exports, "Value", { enumerable: true, get: function () { return struct_1.Value; } });
+Object.defineProperty(exports, "ListValue", { enumerable: true, get: function () { return struct_1.ListValue; } });

package/dist/kafka/commit-kafka-offset.d.ts

@@ -0,0 +1,16 @@
+type KafkaOffsetContext = {
+    getConsumer(): {
+        commitOffsets(offsets: Array<{
+            topic: string;
+            partition: number;
+            offset: string;
+        }>): Promise<void>;
+    };
+    getTopic(): string;
+    getPartition(): number;
+    getMessage(): {
+        offset: string;
+    };
+};
+export declare function commitKafkaOffset(ctx: KafkaOffsetContext): Promise<void>;
+export {};

package/dist/kafka/commit-kafka-offset.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commitKafkaOffset = commitKafkaOffset;
+// Manually commits the next offset for a consumed message. Use after a handler has
+// durably processed (and idempotently deduped) a message, so a crash mid-handler
+// reprocesses rather than silently skips.
+async function commitKafkaOffset(ctx) {
+    const consumer = ctx.getConsumer();
+    const topic = ctx.getTopic();
+    const partition = ctx.getPartition();
+    const message = ctx.getMessage();
+    const nextOffset = (BigInt(message.offset) + BigInt(1)).toString();
+    await consumer.commitOffsets([{ topic, partition, offset: nextOffset }]);
+}

package/dist/kafka/kafka-topics.d.ts

@@ -0,0 +1,13 @@
+export declare const KafkaTopics: {
+    readonly USER_REGISTERED: "user.registered";
+    readonly USER_PROFILE_UPDATED: "user.profile_updated";
+    readonly USER_DELETED: "user.deleted";
+    readonly PLAN_CHANGED: "plan.changed";
+    readonly ASTROLOGY_CALC_REQUESTED: "astrology.calc.requested";
+    readonly ASTROLOGY_GENERATION_REQUESTED: "astrology.generation.requested";
+    readonly ASTROLOGY_FORECAST_REQUESTED: "astrology.forecast.requested";
+    readonly ASTROLOGY_TRANSIT_FIRE: "astrology.transit.fire";
+    readonly NOTIFICATION_PUSH: "notification.push";
+};
+export type KafkaTopic = (typeof KafkaTopics)[keyof typeof KafkaTopics];
+export declare const dlq: (topic: KafkaTopic | string) => string;

package/dist/kafka/kafka-topics.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dlq = exports.KafkaTopics = void 0;
+// Kafka topic backbone. Partition key = userId (ordering per user + parallelism).
+// All consumers are idempotent; every topic has a derived `.dlq` (see dlq()).
+exports.KafkaTopics = {
+    USER_REGISTERED: "user.registered",
+    USER_PROFILE_UPDATED: "user.profile_updated",
+    USER_DELETED: "user.deleted",
+    PLAN_CHANGED: "plan.changed",
+    ASTROLOGY_CALC_REQUESTED: "astrology.calc.requested",
+    ASTROLOGY_GENERATION_REQUESTED: "astrology.generation.requested",
+    ASTROLOGY_FORECAST_REQUESTED: "astrology.forecast.requested",
+    ASTROLOGY_TRANSIT_FIRE: "astrology.transit.fire",
+    NOTIFICATION_PUSH: "notification.push",
+};
+// Dead-letter topic for a given topic, used after N failed retries.
+const dlq = (topic) => `${topic}.dlq`;
+exports.dlq = dlq;

package/dist/kafka/payloads.d.ts

@@ -0,0 +1,67 @@
+import { KafkaTopics } from "./kafka-topics";
+export type PlanString = "free" | "premium";
+export type PersonalPostType = "daily" | "weekly" | "monthly";
+export interface UserRegisteredPayload {
+    userId: string;
+    email: string;
+    language?: string;
+    birthAt?: string;
+    birthLat?: number;
+    birthLng?: number;
+    timezone?: string;
+    plan: PlanString;
+}
+export type UserProfileUpdatedPayload = UserRegisteredPayload & {
+    recalc?: boolean;
+};
+export interface UserDeletedPayload {
+    userId: string;
+    email: string;
+}
+export interface PlanChangedPayload {
+    userId: string;
+    plan: PlanString;
+    previousPlan: PlanString;
+    subscriptionStatus: string;
+}
+export interface AstrologyCalcRequestedPayload {
+    userId: string;
+    scope: "natal" | "deep";
+}
+export interface AstrologyGenerationRequestedPayload {
+    userId: string;
+    type: PersonalPostType | "general" | "general_translation";
+    periodKey: string;
+    plan?: PlanString;
+    language?: string;
+    sourcePostId?: string;
+}
+export interface AstrologyForecastRequestedPayload {
+    userId: string;
+    fromAt: string;
+    toAt: string;
+}
+export interface AstrologyTransitFirePayload {
+    userId: string;
+    transitEventId: string;
+}
+export interface NotificationPushPayload {
+    userId?: string;
+    email: string;
+    type: string;
+    subject: string;
+    body: string;
+    referenceId?: string;
+    dedupKey: string;
+}
+export interface KafkaPayloadMap {
+    [KafkaTopics.USER_REGISTERED]: UserRegisteredPayload;
+    [KafkaTopics.USER_PROFILE_UPDATED]: UserProfileUpdatedPayload;
+    [KafkaTopics.USER_DELETED]: UserDeletedPayload;
+    [KafkaTopics.PLAN_CHANGED]: PlanChangedPayload;
+    [KafkaTopics.ASTROLOGY_CALC_REQUESTED]: AstrologyCalcRequestedPayload;
+    [KafkaTopics.ASTROLOGY_GENERATION_REQUESTED]: AstrologyGenerationRequestedPayload;
+    [KafkaTopics.ASTROLOGY_FORECAST_REQUESTED]: AstrologyForecastRequestedPayload;
+    [KafkaTopics.ASTROLOGY_TRANSIT_FIRE]: AstrologyTransitFirePayload;
+    [KafkaTopics.NOTIFICATION_PUSH]: NotificationPushPayload;
+}

package/dist/kafka/payloads.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const kafka_topics_1 = require("./kafka-topics");

package/dist/pagination/cursor.d.ts

@@ -0,0 +1,17 @@
+export interface CursorRequest {
+    cursor?: string;
+    limit: number;
+}
+export interface CursorResponse<T> {
+    data: T[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}
+export interface DecodedCursor {
+    v: string;
+    id: string;
+}
+export declare function encodeCursor(v: string, id: string): string;
+export declare function decodeCursor(cursor?: string): DecodedCursor | null;
+export declare function clampLimit(limit: number, max?: number, def?: number): number;
+export declare function buildCursorPage<T>(rows: T[], limit: number, toKey: (row: T) => DecodedCursor): CursorResponse<T>;