@aepstore-dev/contracts 1.40.0 → 1.42.0

package/dist/gen/taxonomy.d.ts

@@ -0,0 +1,109 @@
+import { Observable } from "rxjs";
+export declare const protobufPackage = "taxonomy.v1";
+export interface Category {
+    id: string;
+    name: string;
+    description: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Application {
+    id: string;
+    name: string;
+    description: string;
+    createdAt: string;
+    updatedAt: string;
+    /** public S3 URL to brand SVG (admin-set), empty if none */
+    iconUrl: string;
+}
+export interface Tag {
+    id: string;
+    name: string;
+}
+export interface Empty {
+}
+export interface CategoriesListResponse {
+    items: Category[];
+}
+export interface ApplicationsListResponse {
+    items: Application[];
+}
+export interface QueryTagsRequest {
+    search: string;
+    page: number;
+    limit: number;
+}
+export interface TagsListResponse {
+    items: Tag[];
+    total: number;
+    page: number;
+    limit: number;
+}
+export interface CreateCategoryRequest {
+    name: string;
+    description: string;
+}
+export interface CategoryResponse {
+    category: Category | undefined;
+}
+export interface CreateApplicationRequest {
+    name: string;
+    description: string;
+    iconUrl: string;
+}
+export interface UpdateApplicationRequest {
+    id: string;
+    /** optional — empty keeps current */
+    name: string;
+    /** optional */
+    description: string;
+    /** optional — empty keeps current */
+    iconUrl: string;
+}
+export interface ApplicationResponse {
+    application: Application | undefined;
+}
+export interface CreateIconUploadUrlRequest {
+    fileName: string;
+    /** e.g. image/svg+xml */
+    mimeType: string;
+}
+export interface IconUploadUrlResponse {
+    /** presigned PUT URL — client uploads the SVG bytes here */
+    uploadUrl: string;
+    /** final public URL to store as Application.iconUrl */
+    iconUrl: string;
+    fileKey: string;
+    expiresIn: number;
+}
+export declare const TAXONOMY_V1_PACKAGE_NAME = "taxonomy.v1";
+export interface TaxonomyServiceClient {
+    findAllCategories(request: Empty): Observable<CategoriesListResponse>;
+    findAllApplications(request: Empty): Observable<ApplicationsListResponse>;
+    findAllTags(request: QueryTagsRequest): Observable<TagsListResponse>;
+    createCategory(request: CreateCategoryRequest): Observable<CategoryResponse>;
+    createApplication(request: CreateApplicationRequest): Observable<ApplicationResponse>;
+    updateApplication(request: UpdateApplicationRequest): Observable<ApplicationResponse>;
+    /**
+     * Mint a presigned PUT URL for an application icon SVG (proxies upload-service,
+     * kind=ICON → public/icons/). Client PUTs the bytes to upload_url, then passes
+     * icon_url to Create/UpdateApplication.
+     */
+    createIconUploadUrl(request: CreateIconUploadUrlRequest): Observable<IconUploadUrlResponse>;
+}
+export interface TaxonomyServiceController {
+    findAllCategories(request: Empty): Promise<CategoriesListResponse> | Observable<CategoriesListResponse> | CategoriesListResponse;
+    findAllApplications(request: Empty): Promise<ApplicationsListResponse> | Observable<ApplicationsListResponse> | ApplicationsListResponse;
+    findAllTags(request: QueryTagsRequest): Promise<TagsListResponse> | Observable<TagsListResponse> | TagsListResponse;
+    createCategory(request: CreateCategoryRequest): Promise<CategoryResponse> | Observable<CategoryResponse> | CategoryResponse;
+    createApplication(request: CreateApplicationRequest): Promise<ApplicationResponse> | Observable<ApplicationResponse> | ApplicationResponse;
+    updateApplication(request: UpdateApplicationRequest): Promise<ApplicationResponse> | Observable<ApplicationResponse> | ApplicationResponse;
+    /**
+     * Mint a presigned PUT URL for an application icon SVG (proxies upload-service,
+     * kind=ICON → public/icons/). Client PUTs the bytes to upload_url, then passes
+     * icon_url to Create/UpdateApplication.
+     */
+    createIconUploadUrl(request: CreateIconUploadUrlRequest): Promise<IconUploadUrlResponse> | Observable<IconUploadUrlResponse> | IconUploadUrlResponse;
+}
+export declare function TaxonomyServiceControllerMethods(): (constructor: Function) => void;
+export declare const TAXONOMY_SERVICE_NAME = "TaxonomyService";

package/dist/gen/taxonomy.js

@@ -0,0 +1,36 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.10.1
+//   protoc               v7.35.0
+// source: taxonomy.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TAXONOMY_SERVICE_NAME = exports.TAXONOMY_V1_PACKAGE_NAME = exports.protobufPackage = void 0;
+exports.TaxonomyServiceControllerMethods = TaxonomyServiceControllerMethods;
+/* eslint-disable */
+const microservices_1 = require("@nestjs/microservices");
+exports.protobufPackage = "taxonomy.v1";
+exports.TAXONOMY_V1_PACKAGE_NAME = "taxonomy.v1";
+function TaxonomyServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = [
+            "findAllCategories",
+            "findAllApplications",
+            "findAllTags",
+            "createCategory",
+            "createApplication",
+            "updateApplication",
+            "createIconUploadUrl",
+        ];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcMethod)("TaxonomyService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcStreamMethod)("TaxonomyService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+exports.TAXONOMY_SERVICE_NAME = "TaxonomyService";

package/dist/gen/upload.d.ts

@@ -0,0 +1,193 @@
+import { Observable } from "rxjs";
+export declare const protobufPackage = "upload.v1";
+/**
+ * Determines the object key prefix (and future ACL/privacy policy).
+ * ATTACHMENT = paid product deliverable (private; presigned GET only after purchase).
+ * MEDIA / AVATAR / BANNER = preview assets.
+ */
+export declare enum UploadKind {
+    UPLOAD_KIND_UNSPECIFIED = 0,
+    UPLOAD_KIND_ATTACHMENT = 1,
+    UPLOAD_KIND_MEDIA = 2,
+    UPLOAD_KIND_AVATAR = 3,
+    UPLOAD_KIND_BANNER = 4,
+    /** UPLOAD_KIND_ICON - taxonomy program/app brand icons → public/icons/ */
+    UPLOAD_KIND_ICON = 5,
+    UNRECOGNIZED = -1
+}
+export interface ListObjectsRequest {
+    prefix: string;
+    /** empty for the first page */
+    continuationToken: string;
+}
+export interface StoredObject {
+    key: string;
+    /** ISO 8601 */
+    lastModified: string;
+}
+export interface ListObjectsResponse {
+    objects: StoredObject[];
+    /** empty when there are no more pages */
+    nextContinuationToken: string;
+}
+export interface Ok {
+    ok: boolean;
+}
+export interface CreateMultipartUploadRequest {
+    fileName: string;
+    mimeType: string;
+    fileSize: number;
+    kind: UploadKind;
+    /** user initiating, for key namespacing + audit */
+    ownerId: string;
+}
+export interface CreateMultipartUploadResponse {
+    /** S3 multipart UploadId */
+    uploadId: string;
+    /** object key this service generated */
+    fileKey: string;
+    /** recommended part size (bytes) the client should slice with */
+    partSize: number;
+    /** number of parts for file_size at part_size */
+    partCount: number;
+}
+export interface SignPartRequest {
+    fileKey: string;
+    uploadId: string;
+    /** 1-based */
+    partNumber: number;
+}
+export interface SignPartResponse {
+    /** presigned PUT URL for this single part */
+    url: string;
+    expiresIn: number;
+}
+export interface CompletedPart {
+    partNumber: number;
+    /** ETag the client received in the S3 PUT response header for this part */
+    etag: string;
+}
+export interface CompleteMultipartUploadRequest {
+    fileKey: string;
+    uploadId: string;
+    parts: CompletedPart[];
+}
+export interface CompleteMultipartUploadResponse {
+    fileKey: string;
+    /** final object location (internal reference) */
+    location: string;
+    fileSize: number;
+}
+export interface AbortMultipartUploadRequest {
+    fileKey: string;
+    uploadId: string;
+}
+export interface CreateUploadUrlRequest {
+    fileName: string;
+    mimeType: string;
+    kind: UploadKind;
+    ownerId: string;
+}
+export interface CreateUploadUrlResponse {
+    /** presigned PUT URL (client PUTs the whole file) */
+    url: string;
+    fileKey: string;
+    expiresIn: number;
+    /** final object URL (only meaningful for public kinds) */
+    publicUrl: string;
+}
+export interface SignedUrlRequest {
+    fileKey: string;
+    /** optional, default 3600 */
+    expiresIn: number;
+    /** optional: forces Content-Disposition attachment filename */
+    downloadFileName: string;
+}
+export interface SignedUrlResponse {
+    signedUrl: string;
+    expiresIn: number;
+}
+export interface HeadObjectRequest {
+    fileKey: string;
+}
+export interface HeadObjectResponse {
+    /** false only when the object is definitively absent (404) */
+    exists: boolean;
+    /** bytes (0 when absent) */
+    size: number;
+    contentType: string;
+}
+export interface DeleteObjectRequest {
+    fileKey: string;
+}
+export declare const UPLOAD_V1_PACKAGE_NAME = "upload.v1";
+/**
+ * Thin signing service. File bytes NEVER pass through this service — clients
+ * upload/download directly to/from S3 (Yandex Object Storage) using presigned
+ * URLs this service mints. Memory/bandwidth flat regardless of file size.
+ *
+ * Large files (product deliverables, up to ~1GB) use the multipart flow:
+ *   CreateMultipartUpload → (SignPart × N, client PUTs each part to S3) →
+ *   CompleteMultipartUpload   (or AbortMultipartUpload on failure)
+ *
+ * Small files (preview images, avatars) use the single-PUT flow: CreateUploadUrl.
+ *
+ * Downloads are gated elsewhere (products-service verifies purchase, then calls
+ * GenerateSignedUrl). This service does not know about purchases.
+ */
+export interface UploadServiceClient {
+    createMultipartUpload(request: CreateMultipartUploadRequest): Observable<CreateMultipartUploadResponse>;
+    signPart(request: SignPartRequest): Observable<SignPartResponse>;
+    completeMultipartUpload(request: CompleteMultipartUploadRequest): Observable<CompleteMultipartUploadResponse>;
+    abortMultipartUpload(request: AbortMultipartUploadRequest): Observable<Ok>;
+    createUploadUrl(request: CreateUploadUrlRequest): Observable<CreateUploadUrlResponse>;
+    generateSignedUrl(request: SignedUrlRequest): Observable<SignedUrlResponse>;
+    /**
+     * Verify an object actually exists (and read its size/type). Used by
+     * products-service to confirm a client-echoed fileKey points at a real
+     * uploaded object before persisting attachment metadata.
+     */
+    headObject(request: HeadObjectRequest): Observable<HeadObjectResponse>;
+    deleteObject(request: DeleteObjectRequest): Observable<Ok>;
+    /**
+     * List objects under a prefix (paginated) — for GC/reconciliation jobs
+     * (e.g. tasks-service sweeping orphaned uploads). Not for user traffic.
+     */
+    listObjects(request: ListObjectsRequest): Observable<ListObjectsResponse>;
+}
+/**
+ * Thin signing service. File bytes NEVER pass through this service — clients
+ * upload/download directly to/from S3 (Yandex Object Storage) using presigned
+ * URLs this service mints. Memory/bandwidth flat regardless of file size.
+ *
+ * Large files (product deliverables, up to ~1GB) use the multipart flow:
+ *   CreateMultipartUpload → (SignPart × N, client PUTs each part to S3) →
+ *   CompleteMultipartUpload   (or AbortMultipartUpload on failure)
+ *
+ * Small files (preview images, avatars) use the single-PUT flow: CreateUploadUrl.
+ *
+ * Downloads are gated elsewhere (products-service verifies purchase, then calls
+ * GenerateSignedUrl). This service does not know about purchases.
+ */
+export interface UploadServiceController {
+    createMultipartUpload(request: CreateMultipartUploadRequest): Promise<CreateMultipartUploadResponse> | Observable<CreateMultipartUploadResponse> | CreateMultipartUploadResponse;
+    signPart(request: SignPartRequest): Promise<SignPartResponse> | Observable<SignPartResponse> | SignPartResponse;
+    completeMultipartUpload(request: CompleteMultipartUploadRequest): Promise<CompleteMultipartUploadResponse> | Observable<CompleteMultipartUploadResponse> | CompleteMultipartUploadResponse;
+    abortMultipartUpload(request: AbortMultipartUploadRequest): Promise<Ok> | Observable<Ok> | Ok;
+    createUploadUrl(request: CreateUploadUrlRequest): Promise<CreateUploadUrlResponse> | Observable<CreateUploadUrlResponse> | CreateUploadUrlResponse;
+    generateSignedUrl(request: SignedUrlRequest): Promise<SignedUrlResponse> | Observable<SignedUrlResponse> | SignedUrlResponse;
+    /**
+     * Verify an object actually exists (and read its size/type). Used by
+     * products-service to confirm a client-echoed fileKey points at a real
+     * uploaded object before persisting attachment metadata.
+     */
+    headObject(request: HeadObjectRequest): Promise<HeadObjectResponse> | Observable<HeadObjectResponse> | HeadObjectResponse;
+    deleteObject(request: DeleteObjectRequest): Promise<Ok> | Observable<Ok> | Ok;
+    /**
+     * List objects under a prefix (paginated) — for GC/reconciliation jobs
+     * (e.g. tasks-service sweeping orphaned uploads). Not for user traffic.
+     */
+    listObjects(request: ListObjectsRequest): Promise<ListObjectsResponse> | Observable<ListObjectsResponse> | ListObjectsResponse;
+}
+export declare function UploadServiceControllerMethods(): (constructor: Function) => void;
+export declare const UPLOAD_SERVICE_NAME = "UploadService";

package/dist/gen/upload.js

@@ -0,0 +1,54 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.10.1
+//   protoc               v7.35.0
+// source: upload.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UPLOAD_SERVICE_NAME = exports.UPLOAD_V1_PACKAGE_NAME = exports.UploadKind = exports.protobufPackage = void 0;
+exports.UploadServiceControllerMethods = UploadServiceControllerMethods;
+/* eslint-disable */
+const microservices_1 = require("@nestjs/microservices");
+exports.protobufPackage = "upload.v1";
+/**
+ * Determines the object key prefix (and future ACL/privacy policy).
+ * ATTACHMENT = paid product deliverable (private; presigned GET only after purchase).
+ * MEDIA / AVATAR / BANNER = preview assets.
+ */
+var UploadKind;
+(function (UploadKind) {
+    UploadKind[UploadKind["UPLOAD_KIND_UNSPECIFIED"] = 0] = "UPLOAD_KIND_UNSPECIFIED";
+    UploadKind[UploadKind["UPLOAD_KIND_ATTACHMENT"] = 1] = "UPLOAD_KIND_ATTACHMENT";
+    UploadKind[UploadKind["UPLOAD_KIND_MEDIA"] = 2] = "UPLOAD_KIND_MEDIA";
+    UploadKind[UploadKind["UPLOAD_KIND_AVATAR"] = 3] = "UPLOAD_KIND_AVATAR";
+    UploadKind[UploadKind["UPLOAD_KIND_BANNER"] = 4] = "UPLOAD_KIND_BANNER";
+    /** UPLOAD_KIND_ICON - taxonomy program/app brand icons → public/icons/ */
+    UploadKind[UploadKind["UPLOAD_KIND_ICON"] = 5] = "UPLOAD_KIND_ICON";
+    UploadKind[UploadKind["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(UploadKind || (exports.UploadKind = UploadKind = {}));
+exports.UPLOAD_V1_PACKAGE_NAME = "upload.v1";
+function UploadServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = [
+            "createMultipartUpload",
+            "signPart",
+            "completeMultipartUpload",
+            "abortMultipartUpload",
+            "createUploadUrl",
+            "generateSignedUrl",
+            "headObject",
+            "deleteObject",
+            "listObjects",
+        ];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcMethod)("UploadService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            (0, microservices_1.GrpcStreamMethod)("UploadService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+exports.UPLOAD_SERVICE_NAME = "UploadService";