@sagebox-be/proto-contracts 1.0.0

package/README.md

@@ -0,0 +1,148 @@
+# @sagebox-be/proto-contracts
+
+Sagebox gRPC Protocol Buffer contracts and TypeScript type definitions.
+
+## 📦 Installation
+
+```bash
+npm install @sagebox-be/proto-contracts
+# or
+yarn add @sagebox-be/proto-contracts
+# or
+pnpm add @sagebox-be/proto-contracts
+```
+
+## 🚀 Usage
+
+### Import TypeScript Types
+
+```typescript
+import {
+  ProductServiceClient,
+  ProductServiceController,
+  GetProductByIdRequest,
+  ProductResponse,
+  getProtoPath,
+  getAllProtosPaths,
+} from '@sagebox-be/proto-contracts';
+```
+
+### Use in NestJS gRPC Microservice
+
+```typescript
+import { Module } from '@nestjs/common';
+import { Transport, ClientsModule } from '@nestjs/microservices';
+import { getProtoPath } from '@sagebox-be/proto-contracts';
+
+@Module({
+  imports: [
+    ClientsModule.register([
+      {
+        name: 'PRODUCT_SERVICE',
+        transport: Transport.GRPC,
+        options: {
+          package: 'product',
+          protoPath: getProtoPath('product.proto'),
+          url: 'localhost:5000',
+        },
+      },
+    ]),
+  ],
+})
+export class AppModule {}
+```
+
+### Use in Node.js gRPC Client
+
+```typescript
+import * as grpc from '@grpc/grpc-js';
+import * as protoLoader from '@grpc/proto-loader';
+import { getProtoPath } from '@sagebox-be/proto-contracts';
+import type { ProductServiceClient } from '@sagebox-be/proto-contracts';
+
+const PROTO_PATH = getProtoPath('product.proto');
+
+const packageDefinition = protoLoader.loadSync(PROTO_PATH, {
+  keepCase: true,
+  longs: String,
+  enums: String,
+  defaults: true,
+  oneofs: true,
+});
+
+const protoDescriptor = grpc.loadPackageDefinition(packageDefinition);
+const productProto = protoDescriptor.product as any;
+
+const client: ProductServiceClient = new productProto.ProductService(
+  'localhost:5000',
+  grpc.credentials.createInsecure()
+);
+
+// Make gRPC calls
+client.getProductById({ id: 'product-123' }, (error, response) => {
+  if (error) {
+    console.error(error);
+  } else {
+    console.log(response);
+  }
+});
+```
+
+### Use Proto Files Directly
+
+```typescript
+import { getAllProtosPaths } from '@sagebox-be/proto-contracts';
+
+const protoPaths = getAllProtosPaths();
+console.log(protoPaths.product); // Path to product.proto
+```
+
+## 📁 Package Contents
+
+- **TypeScript Types**: Generated from proto files with full type safety
+- **Proto Files**: Original `.proto` files for gRPC code generation in any language
+- **Helper Functions**: Utilities to get proto file paths
+
+## 🔧 Development
+
+### Generate Types from Proto
+
+```bash
+npm run proto:generate
+```
+
+### Build Package
+
+```bash
+npm run build
+```
+
+### Publish
+
+```bash
+npm publish
+```
+
+## 📖 Available Services
+
+### ProductService
+
+#### Methods
+
+- `GetProductsByCategoryId(GetProductsByCategoryIdRequest): GetProductsResponse`
+- `GetProductById(GetProductByIdRequest): ProductResponse`
+- `CreateProduct(CreateProductRequest): ProductResponse`
+
+## 🤝 Contributing
+
+When adding new proto files:
+
+1. Add the `.proto` file to `proto/` directory
+2. Run `npm run proto:generate` to generate TypeScript types
+3. Export types in `src/index.ts`
+4. Update `getAllProtosPaths()` in `src/utils.ts`
+5. Build and publish
+
+## 📝 License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interfaces/product';
+export { getProtoPath } from './utils';

package/dist/index.js

@@ -0,0 +1,22 @@
+"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 });
+exports.getProtoPath = void 0;
+// Export all gRPC interfaces and types
+__exportStar(require("./interfaces/product"), exports);
+// Export proto file path helper
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "getProtoPath", { enumerable: true, get: function () { return utils_1.getProtoPath; } });

package/dist/interfaces/product.d.ts

@@ -0,0 +1,91 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import type { Metadata } from "@grpc/grpc-js";
+import { Observable } from "rxjs";
+export declare const protobufPackage = "product";
+/** Request messages */
+export interface GetProductsByCategoryIdRequest {
+    categoryId: string;
+}
+export interface GetProductByIdRequest {
+    id: string;
+}
+export interface CreateProductRequest {
+    name: string;
+    title: string;
+    description: string;
+    categoryId: string;
+    storeId: string;
+    status: string;
+    mediaKeys: string[];
+    skus: ProductSkuInput[];
+}
+/** Response messages */
+export interface GetProductsResponse {
+    products: Product[];
+}
+export interface ProductResponse {
+    product: Product | undefined;
+    error: string;
+}
+/** Data structures */
+export interface Product {
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    keywords: string;
+    categoryId: string;
+    storeId: string;
+    viewedCount: number;
+    status: string;
+    url: string;
+    media: Media[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Media {
+    id: string;
+    key: string;
+    url: string;
+    type: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ProductSkuInput {
+    price: number;
+    quantity: number;
+    brand?: string | undefined;
+    mediaKeys: string[];
+    attributeValues: AttributeValueInput[];
+}
+export interface AttributeValueInput {
+    attrId: string;
+    value: string;
+    name: string;
+}
+export declare const PRODUCT_PACKAGE_NAME = "product";
+export declare const GetProductsByCategoryIdRequest: MessageFns<GetProductsByCategoryIdRequest>;
+export declare const GetProductByIdRequest: MessageFns<GetProductByIdRequest>;
+export declare const CreateProductRequest: MessageFns<CreateProductRequest>;
+export declare const GetProductsResponse: MessageFns<GetProductsResponse>;
+export declare const ProductResponse: MessageFns<ProductResponse>;
+export declare const Product: MessageFns<Product>;
+export declare const Media: MessageFns<Media>;
+export declare const ProductSkuInput: MessageFns<ProductSkuInput>;
+export declare const AttributeValueInput: MessageFns<AttributeValueInput>;
+export interface ProductServiceClient {
+    getProductsByCategoryId(request: GetProductsByCategoryIdRequest, metadata?: Metadata): Observable<GetProductsResponse>;
+    getProductById(request: GetProductByIdRequest, metadata?: Metadata): Observable<ProductResponse>;
+    createProduct(request: CreateProductRequest, metadata?: Metadata): Observable<ProductResponse>;
+}
+export interface ProductServiceController {
+    getProductsByCategoryId(request: GetProductsByCategoryIdRequest, metadata?: Metadata): Promise<GetProductsResponse> | Observable<GetProductsResponse> | GetProductsResponse;
+    getProductById(request: GetProductByIdRequest, metadata?: Metadata): Promise<ProductResponse> | Observable<ProductResponse> | ProductResponse;
+    createProduct(request: CreateProductRequest, metadata?: Metadata): Promise<ProductResponse> | Observable<ProductResponse> | ProductResponse;
+}
+export declare function ProductServiceControllerMethods(): (constructor: Function) => void;
+export declare const PRODUCT_SERVICE_NAME = "ProductService";
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+}

package/dist/interfaces/product.js

@@ -0,0 +1,650 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.8.3
+//   protoc               v6.33.2
+// source: product.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRODUCT_SERVICE_NAME = exports.AttributeValueInput = exports.ProductSkuInput = exports.Media = exports.Product = exports.ProductResponse = exports.GetProductsResponse = exports.CreateProductRequest = exports.GetProductByIdRequest = exports.GetProductsByCategoryIdRequest = exports.PRODUCT_PACKAGE_NAME = exports.protobufPackage = void 0;
+exports.ProductServiceControllerMethods = ProductServiceControllerMethods;
+/* eslint-disable */
+const wire_1 = require("@bufbuild/protobuf/wire");
+const microservices_1 = require("@nestjs/microservices");
+exports.protobufPackage = "product";
+exports.PRODUCT_PACKAGE_NAME = "product";
+function createBaseGetProductsByCategoryIdRequest() {
+    return { categoryId: "" };
+}
+exports.GetProductsByCategoryIdRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.categoryId !== "") {
+            writer.uint32(10).string(message.categoryId);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseGetProductsByCategoryIdRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.categoryId = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+};
+function createBaseGetProductByIdRequest() {
+    return { id: "" };
+}
+exports.GetProductByIdRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.id !== "") {
+            writer.uint32(10).string(message.id);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseGetProductByIdRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.id = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+};
+function createBaseCreateProductRequest() {
+    return { name: "", title: "", description: "", categoryId: "", storeId: "", status: "", mediaKeys: [], skus: [] };
+}
+exports.CreateProductRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.name !== "") {
+            writer.uint32(10).string(message.name);
+        }
+        if (message.title !== "") {
+            writer.uint32(18).string(message.title);
+        }
+        if (message.description !== "") {
+            writer.uint32(26).string(message.description);
+        }
+        if (message.categoryId !== "") {
+            writer.uint32(34).string(message.categoryId);
+        }
+        if (message.storeId !== "") {
+            writer.uint32(42).string(message.storeId);
+        }
+        if (message.status !== "") {
+            writer.uint32(50).string(message.status);
+        }
+        for (const v of message.mediaKeys) {
+            writer.uint32(58).string(v);
+        }
+        for (const v of message.skus) {
+            exports.ProductSkuInput.encode(v, writer.uint32(66).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseCreateProductRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.name = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.title = reader.string();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.description = reader.string();
+                    continue;
+                }
+                case 4: {
+                    if (tag !== 34) {
+                        break;
+                    }
+                    message.categoryId = reader.string();
+                    continue;
+                }
+                case 5: {
+                    if (tag !== 42) {
+                        break;
+                    }
+                    message.storeId = reader.string();
+                    continue;
+                }
+                case 6: {
+                    if (tag !== 50) {
+                        break;
+                    }
+                    message.status = reader.string();
+                    continue;
+                }
+                case 7: {
+                    if (tag !== 58) {
+                        break;
+                    }
+                    message.mediaKeys.push(reader.string());
+                    continue;
+                }
+                case 8: {
+                    if (tag !== 66) {
+                        break;
+                    }
+                    message.skus.push(exports.ProductSkuInput.decode(reader, reader.uint32()));
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+};
+function createBaseGetProductsResponse() {
+    return { products: [] };
+}
+exports.GetProductsResponse = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        for (const v of message.products) {
+            exports.Product.encode(v, writer.uint32(10).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseGetProductsResponse();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.products.push(exports.Product.decode(reader, reader.uint32()));
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+};
+function createBaseProductResponse() {
+    return { product: undefined, error: "" };
+}
+exports.ProductResponse = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.product !== undefined) {
+            exports.Product.encode(message.product, writer.uint32(10).fork()).join();
+        }
+        if (message.error !== "") {
+            writer.uint32(18).string(message.error);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseProductResponse();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.product = exports.Product.decode(reader, reader.uint32());
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.error = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+};
+function createBaseProduct() {
+    return {
+        id: "",
+        name: "",
+        title: "",
+        description: "",
+        keywords: "",
+        categoryId: "",
+        storeId: "",
+        viewedCount: 0,
+        status: "",
+        url: "",
+        media: [],
+        createdAt: "",
+        updatedAt: "",
+    };
+}
+exports.Product = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.id !== "") {
+            writer.uint32(10).string(message.id);
+        }
+        if (message.name !== "") {
+            writer.uint32(18).string(message.name);
+        }
+        if (message.title !== "") {
+            writer.uint32(26).string(message.title);
+        }
+        if (message.description !== "") {
+            writer.uint32(34).string(message.description);
+        }
+        if (message.keywords !== "") {
+            writer.uint32(42).string(message.keywords);
+        }
+        if (message.categoryId !== "") {
+            writer.uint32(50).string(message.categoryId);
+        }
+        if (message.storeId !== "") {
+            writer.uint32(58).string(message.storeId);
+        }
+        if (message.viewedCount !== 0) {
+            writer.uint32(64).int32(message.viewedCount);
+        }
+        if (message.status !== "") {
+            writer.uint32(74).string(message.status);
+        }
+        if (message.url !== "") {
+            writer.uint32(82).string(message.url);
+        }
+        for (const v of message.media) {
+            exports.Media.encode(v, writer.uint32(90).fork()).join();
+        }
+        if (message.createdAt !== "") {
+            writer.uint32(98).string(message.createdAt);
+        }
+        if (message.updatedAt !== "") {
+            writer.uint32(106).string(message.updatedAt);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseProduct();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.id = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.name = reader.string();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.title = reader.string();
+                    continue;
+                }
+                case 4: {
+                    if (tag !== 34) {
+                        break;
+                    }
+                    message.description = reader.string();
+                    continue;
+                }
+                case 5: {
+                    if (tag !== 42) {
+                        break;
+                    }
+                    message.keywords = reader.string();
+                    continue;
+                }
+                case 6: {
+                    if (tag !== 50) {
+                        break;
+                    }
+                    message.categoryId = reader.string();
+                    continue;
+                }
+                case 7: {
+                    if (tag !== 58) {
+                        break;
+                    }
+                    message.storeId = reader.string();
+                    continue;
+                }
+                case 8: {
+                    if (tag !== 64) {
+                        break;
+                    }
+                    message.viewedCount = reader.int32();
+                    continue;
+                }
+                case 9: {
+                    if (tag !== 74) {
+                        break;
+                    }
+                    message.status = reader.string();
+                    continue;
+                }
+                case 10: {
+                    if (tag !== 82) {
+                        break;
+                    }
+                    message.url = reader.string();
+                    continue;
+                }
+                case 11: {
+                    if (tag !== 90) {
+                        break;
+                    }
+                    message.media.push(exports.Media.decode(reader, reader.uint32()));
+                    continue;
+                }
+                case 12: {
+                    if (tag !== 98) {
+                        break;
+                    }
+                    message.createdAt = reader.string();
+                    continue;
+                }
+                case 13: {
+                    if (tag !== 106) {
+                        break;
+                    }
+                    message.updatedAt = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+};
+function createBaseMedia() {
+    return { id: "", key: "", url: "", type: "", createdAt: "", updatedAt: "" };
+}
+exports.Media = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.id !== "") {
+            writer.uint32(10).string(message.id);
+        }
+        if (message.key !== "") {
+            writer.uint32(18).string(message.key);
+        }
+        if (message.url !== "") {
+            writer.uint32(26).string(message.url);
+        }
+        if (message.type !== "") {
+            writer.uint32(34).string(message.type);
+        }
+        if (message.createdAt !== "") {
+            writer.uint32(42).string(message.createdAt);
+        }
+        if (message.updatedAt !== "") {
+            writer.uint32(50).string(message.updatedAt);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseMedia();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.id = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.key = reader.string();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.url = reader.string();
+                    continue;
+                }
+                case 4: {
+                    if (tag !== 34) {
+                        break;
+                    }
+                    message.type = reader.string();
+                    continue;
+                }
+                case 5: {
+                    if (tag !== 42) {
+                        break;
+                    }
+                    message.createdAt = reader.string();
+                    continue;
+                }
+                case 6: {
+                    if (tag !== 50) {
+                        break;
+                    }
+                    message.updatedAt = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+};
+function createBaseProductSkuInput() {
+    return { price: 0, quantity: 0, mediaKeys: [], attributeValues: [] };
+}
+exports.ProductSkuInput = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.price !== 0) {
+            writer.uint32(8).int32(message.price);
+        }
+        if (message.quantity !== 0) {
+            writer.uint32(16).int32(message.quantity);
+        }
+        if (message.brand !== undefined) {
+            writer.uint32(26).string(message.brand);
+        }
+        for (const v of message.mediaKeys) {
+            writer.uint32(34).string(v);
+        }
+        for (const v of message.attributeValues) {
+            exports.AttributeValueInput.encode(v, writer.uint32(42).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseProductSkuInput();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 8) {
+                        break;
+                    }
+                    message.price = reader.int32();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 16) {
+                        break;
+                    }
+                    message.quantity = reader.int32();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.brand = reader.string();
+                    continue;
+                }
+                case 4: {
+                    if (tag !== 34) {
+                        break;
+                    }
+                    message.mediaKeys.push(reader.string());
+                    continue;
+                }
+                case 5: {
+                    if (tag !== 42) {
+                        break;
+                    }
+                    message.attributeValues.push(exports.AttributeValueInput.decode(reader, reader.uint32()));
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+};
+function createBaseAttributeValueInput() {
+    return { attrId: "", value: "", name: "" };
+}
+exports.AttributeValueInput = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.attrId !== "") {
+            writer.uint32(10).string(message.attrId);
+        }
+        if (message.value !== "") {
+            writer.uint32(18).string(message.value);
+        }
+        if (message.name !== "") {
+            writer.uint32(26).string(message.name);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseAttributeValueInput();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.attrId = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.value = reader.string();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.name = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+};
+function ProductServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = ["getProductsByCategoryId", "getProductById", "createProduct"];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcMethod)("ProductService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcStreamMethod)("ProductService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+exports.PRODUCT_SERVICE_NAME = "ProductService";

package/dist/utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Get the absolute path to a proto file
+ * @param protoFileName - The name of the proto file (e.g., 'product.proto')
+ * @returns The absolute path to the proto file
+ */
+export declare function getProtoPath(protoFileName: string): string;
+/**
+ * Get all proto file paths
+ * @returns Object with proto file paths
+ */
+export declare function getAllProtosPaths(): {
+    product: string;
+};

package/dist/utils.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProtoPath = getProtoPath;
+exports.getAllProtosPaths = getAllProtosPaths;
+const path_1 = require("path");
+/**
+ * Get the absolute path to a proto file
+ * @param protoFileName - The name of the proto file (e.g., 'product.proto')
+ * @returns The absolute path to the proto file
+ */
+function getProtoPath(protoFileName) {
+    return (0, path_1.join)(__dirname, '../proto', protoFileName);
+}
+/**
+ * Get all proto file paths
+ * @returns Object with proto file paths
+ */
+function getAllProtosPaths() {
+    return {
+        product: getProtoPath('product.proto'),
+    };
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@sagebox-be/proto-contracts",
+  "version": "1.0.0",
+  "description": "Sagebox gRPC Protocol Buffer contracts and TypeScript definitions",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "proto/**/*.proto",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "proto:copy": "cp -r ../common/src/grpc/proto ./proto",
+    "proto:generate": "../../bin/proto-generate.sh"
+  },
+  "keywords": [
+    "grpc",
+    "protobuf",
+    "protocol-buffers",
+    "sagebox",
+    "typescript"
+  ],
+  "author": "Sagebox Team",
+  "license": "MIT",
+  "devDependencies": {
+    "@grpc/grpc-js": "^1.14.3",
+    "@grpc/proto-loader": "^0.8.0",
+    "@nestjs/microservices": "^11.1.9",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@grpc/grpc-js": "^1.14.0",
+    "@grpc/proto-loader": "^0.8.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/proto/product.proto

@@ -0,0 +1,79 @@
+syntax = "proto3";
+
+package product;
+
+service ProductService {
+  rpc GetProductsByCategoryId(GetProductsByCategoryIdRequest) returns (GetProductsResponse);
+  rpc GetProductById(GetProductByIdRequest) returns (ProductResponse);
+  rpc CreateProduct(CreateProductRequest) returns (ProductResponse);
+}
+
+// Request messages
+message GetProductsByCategoryIdRequest {
+  string categoryId = 1;
+}
+
+message GetProductByIdRequest {
+  string id = 1;
+}
+
+message CreateProductRequest {
+  string name = 1;
+  string title = 2;
+  string description = 3;
+  string categoryId = 4;
+  string storeId = 5;
+  string status = 6;
+  repeated string mediaKeys = 7;
+  repeated ProductSkuInput skus = 8;
+}
+
+// Response messages
+message GetProductsResponse {
+  repeated Product products = 1;
+}
+
+message ProductResponse {
+  Product product = 1;
+  string error = 2;
+}
+
+// Data structures
+message Product {
+  string id = 1;
+  string name = 2;
+  string title = 3;
+  string description = 4;
+  string keywords = 5;
+  string categoryId = 6;
+  string storeId = 7;
+  int32 viewedCount = 8;
+  string status = 9;
+  string url = 10;
+  repeated Media media = 11;
+  string createdAt = 12;
+  string updatedAt = 13;
+}
+
+message Media {
+  string id = 1;
+  string key = 2;
+  string url = 3;
+  string type = 4;
+  string createdAt = 5;
+  string updatedAt = 6;
+}
+
+message ProductSkuInput {
+  int32 price = 1;
+  int32 quantity = 2;
+  optional string brand = 3;
+  repeated string mediaKeys = 4;
+  repeated AttributeValueInput attributeValues = 5;
+}
+
+message AttributeValueInput {
+  string attrId = 1;
+  string value = 2;
+  string name = 3;
+}