@unifiedcommerce/core 0.4.4 → 0.5.0

package/dist/interfaces/rest/schemas/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/rest/schemas/catalog.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/rest/schemas/catalog.js

@@ -0,0 +1,397 @@
+import { z, createRoute } from "@hono/zod-openapi";
+import { errorResponses } from "./shared.js";
+import { CatalogEntityResponse, CatalogEntityListResponse } from "./responses.js";
+import { CreateEntityBodySchema, UpdateEntityBodySchema, SetAttributesBodySchema, CreateCategoryBodySchema, UpdateCategoryBodySchema, CreateBrandBodySchema, UpdateBrandBodySchema, CreateOptionTypeBodySchema, CreateOptionValueBodySchema, CreateVariantBodySchema, GenerateVariantsBodySchema, } from "../../../modules/catalog/schemas.js";
+// ─── Response Schemas ───────────────────────────────────────────────────────
+const DataResponse = CatalogEntityResponse;
+const DataWithPaginationResponse = CatalogEntityListResponse;
+// ─── Path Params ────────────────────────────────────────────────────────────
+const EntityIdOrSlugParam = z.object({
+    idOrSlug: z.string().min(1).openapi({ example: "my-product" }),
+});
+const EntityIdParam = z.object({
+    id: z.uuid().openapi({ example: "550e8400-e29b-41d4-a716-446655440000" }),
+});
+const EntityIdLocaleParam = z.object({
+    id: z.uuid().openapi({ example: "550e8400-e29b-41d4-a716-446655440000" }),
+    locale: z.string().min(1).openapi({ example: "en" }),
+});
+const CategoryIdParam = z.object({
+    categoryId: z.uuid().openapi({ example: "550e8400-e29b-41d4-a716-446655440000" }),
+});
+const BrandIdParam = z.object({
+    brandId: z.uuid().openapi({ example: "550e8400-e29b-41d4-a716-446655440000" }),
+});
+const EntityCategoryParam = z.object({
+    id: z.uuid().openapi({ example: "550e8400-e29b-41d4-a716-446655440000" }),
+    categoryId: z.uuid().openapi({ example: "660e8400-e29b-41d4-a716-446655440000" }),
+});
+const EntityBrandParam = z.object({
+    id: z.uuid().openapi({ example: "550e8400-e29b-41d4-a716-446655440000" }),
+    brandId: z.uuid().openapi({ example: "660e8400-e29b-41d4-a716-446655440000" }),
+});
+// ─── GET Route Definitions ─────────────────────────────────────────────────
+export const listEntitiesRoute = createRoute({
+    method: "get",
+    path: "/entities",
+    tags: ["Catalog"],
+    summary: "List catalog entities",
+    request: {
+        query: z.object({
+            type: z.string().optional(),
+            status: z.string().optional(),
+            category: z.string().optional(),
+            brand: z.string().optional(),
+            include: z.string().optional(),
+            sort: z.string().optional(),
+            page: z.string().optional(),
+            limit: z.string().optional(),
+        }),
+    },
+    responses: {
+        200: { content: { "application/json": { schema: DataWithPaginationResponse } }, description: "Success" },
+    },
+});
+export const getEntityRoute = createRoute({
+    method: "get",
+    path: "/entities/{idOrSlug}",
+    tags: ["Catalog"],
+    summary: "Get a catalog entity by ID or slug",
+    request: {
+        params: EntityIdOrSlugParam,
+        query: z.object({ include: z.string().optional() }),
+    },
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Success" },
+        ...errorResponses,
+    },
+});
+export const getEntityAttributesRoute = createRoute({
+    method: "get",
+    path: "/entities/{id}/attributes/{locale}",
+    tags: ["Catalog"],
+    summary: "Get entity attributes for a locale",
+    request: { params: EntityIdLocaleParam },
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Success" },
+        ...errorResponses,
+    },
+});
+export const listCategoriesRoute = createRoute({
+    method: "get",
+    path: "/categories",
+    tags: ["Catalog"],
+    summary: "List all categories",
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Success" },
+    },
+});
+export const listBrandsRoute = createRoute({
+    method: "get",
+    path: "/brands",
+    tags: ["Catalog"],
+    summary: "List all brands",
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Success" },
+    },
+});
+// ─── DELETE Route Definitions ──────────────────────────────────────────────
+export const deleteEntityRoute = createRoute({
+    method: "delete",
+    path: "/entities/{id}",
+    tags: ["Catalog"],
+    summary: "Delete a catalog entity",
+    request: { params: EntityIdParam },
+    responses: {
+        200: { content: { "application/json": { schema: z.object({ data: z.object({ deleted: z.literal(true) }) }) } }, description: "Deleted" },
+        ...errorResponses,
+    },
+});
+export const deleteCategoryRoute = createRoute({
+    method: "delete",
+    path: "/categories/{categoryId}",
+    tags: ["Catalog"],
+    summary: "Delete a category",
+    request: { params: CategoryIdParam },
+    responses: {
+        200: { content: { "application/json": { schema: z.object({ data: z.object({ deleted: z.literal(true) }) }) } }, description: "Deleted" },
+        ...errorResponses,
+    },
+});
+export const deleteBrandRoute = createRoute({
+    method: "delete",
+    path: "/brands/{brandId}",
+    tags: ["Catalog"],
+    summary: "Delete a brand",
+    request: { params: BrandIdParam },
+    responses: {
+        200: { content: { "application/json": { schema: z.object({ data: z.object({ deleted: z.literal(true) }) }) } }, description: "Deleted" },
+        ...errorResponses,
+    },
+});
+export const removeEntityFromCategoryRoute = createRoute({
+    method: "delete",
+    path: "/entities/{id}/categories/{categoryId}",
+    tags: ["Catalog"],
+    summary: "Remove entity from category",
+    request: { params: EntityCategoryParam },
+    responses: {
+        200: { content: { "application/json": { schema: z.object({ data: z.object({ unlinked: z.literal(true) }) }) } }, description: "Unlinked" },
+        ...errorResponses,
+    },
+});
+export const removeEntityFromBrandRoute = createRoute({
+    method: "delete",
+    path: "/entities/{id}/brands/{brandId}",
+    tags: ["Catalog"],
+    summary: "Remove entity from brand",
+    request: { params: EntityBrandParam },
+    responses: {
+        200: { content: { "application/json": { schema: z.object({ data: z.object({ unlinked: z.literal(true) }) }) } }, description: "Unlinked" },
+        ...errorResponses,
+    },
+});
+// ─── No-body POST Route Definitions ────────────────────────────────────────
+export const publishEntityRoute = createRoute({
+    method: "post",
+    path: "/entities/{id}/publish",
+    tags: ["Catalog"],
+    summary: "Publish a catalog entity",
+    request: { params: EntityIdParam },
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Published" },
+        ...errorResponses,
+    },
+});
+export const archiveEntityRoute = createRoute({
+    method: "post",
+    path: "/entities/{id}/archive",
+    tags: ["Catalog"],
+    summary: "Archive a catalog entity",
+    request: { params: EntityIdParam },
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Archived" },
+        ...errorResponses,
+    },
+});
+export const discontinueEntityRoute = createRoute({
+    method: "post",
+    path: "/entities/{id}/discontinue",
+    tags: ["Catalog"],
+    summary: "Discontinue a catalog entity",
+    request: { params: EntityIdParam },
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Discontinued" },
+        ...errorResponses,
+    },
+});
+export const addEntityToCategoryRoute = createRoute({
+    method: "post",
+    path: "/entities/{id}/categories/{categoryId}",
+    tags: ["Catalog"],
+    summary: "Add entity to a category",
+    request: { params: EntityCategoryParam },
+    responses: {
+        200: { content: { "application/json": { schema: z.object({ data: z.object({ linked: z.literal(true) }) }) } }, description: "Linked" },
+        ...errorResponses,
+    },
+});
+export const addEntityToBrandRoute = createRoute({
+    method: "post",
+    path: "/entities/{id}/brands/{brandId}",
+    tags: ["Catalog"],
+    summary: "Add entity to a brand",
+    request: { params: EntityBrandParam },
+    responses: {
+        200: { content: { "application/json": { schema: z.object({ data: z.object({ linked: z.literal(true) }) }) } }, description: "Linked" },
+        ...errorResponses,
+    },
+});
+// ─── Mutation Route Definitions ─────────────────────────────────────────────
+const OptionTypeIdParam = z.object({
+    optionTypeId: z.uuid().openapi({ example: "550e8400-e29b-41d4-a716-446655440000" }),
+});
+export const createEntityRoute = createRoute({
+    method: "post",
+    path: "/entities",
+    tags: ["Catalog"],
+    summary: "Create a catalog entity",
+    request: {
+        body: {
+            content: { "application/json": { schema: CreateEntityBodySchema } },
+            required: true,
+        },
+    },
+    responses: {
+        201: { content: { "application/json": { schema: DataResponse } }, description: "Created" },
+        ...errorResponses,
+    },
+});
+export const updateEntityRoute = createRoute({
+    method: "patch",
+    path: "/entities/{id}",
+    tags: ["Catalog"],
+    summary: "Update a catalog entity",
+    request: {
+        params: EntityIdParam,
+        body: {
+            content: { "application/json": { schema: UpdateEntityBodySchema } },
+            required: true,
+        },
+    },
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Updated" },
+        ...errorResponses,
+    },
+});
+export const setEntityAttributesRoute = createRoute({
+    method: "put",
+    path: "/entities/{id}/attributes/{locale}",
+    tags: ["Catalog"],
+    summary: "Set entity attributes for a locale",
+    request: {
+        params: EntityIdLocaleParam,
+        body: {
+            content: { "application/json": { schema: SetAttributesBodySchema } },
+            required: true,
+        },
+    },
+    responses: {
+        200: { content: { "application/json": { schema: z.object({ data: z.object({ updated: z.literal(true) }) }) } }, description: "Updated" },
+        ...errorResponses,
+    },
+});
+export const createCategoryRoute = createRoute({
+    method: "post",
+    path: "/categories",
+    tags: ["Catalog"],
+    summary: "Create a category",
+    request: {
+        body: {
+            content: { "application/json": { schema: CreateCategoryBodySchema } },
+            required: true,
+        },
+    },
+    responses: {
+        201: { content: { "application/json": { schema: DataResponse } }, description: "Created" },
+        ...errorResponses,
+    },
+});
+export const updateCategoryRoute = createRoute({
+    method: "patch",
+    path: "/categories/{categoryId}",
+    tags: ["Catalog"],
+    summary: "Update a category",
+    request: {
+        params: CategoryIdParam,
+        body: {
+            content: { "application/json": { schema: UpdateCategoryBodySchema } },
+            required: true,
+        },
+    },
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Updated" },
+        ...errorResponses,
+    },
+});
+export const createBrandRoute = createRoute({
+    method: "post",
+    path: "/brands",
+    tags: ["Catalog"],
+    summary: "Create a brand",
+    request: {
+        body: {
+            content: { "application/json": { schema: CreateBrandBodySchema } },
+            required: true,
+        },
+    },
+    responses: {
+        201: { content: { "application/json": { schema: DataResponse } }, description: "Created" },
+        ...errorResponses,
+    },
+});
+export const updateBrandRoute = createRoute({
+    method: "patch",
+    path: "/brands/{brandId}",
+    tags: ["Catalog"],
+    summary: "Update a brand",
+    request: {
+        params: BrandIdParam,
+        body: {
+            content: { "application/json": { schema: UpdateBrandBodySchema } },
+            required: true,
+        },
+    },
+    responses: {
+        200: { content: { "application/json": { schema: DataResponse } }, description: "Updated" },
+        ...errorResponses,
+    },
+});
+export const createOptionTypeRoute = createRoute({
+    method: "post",
+    path: "/entities/{id}/options",
+    tags: ["Catalog"],
+    summary: "Create an option type for an entity",
+    request: {
+        params: EntityIdParam,
+        body: {
+            content: { "application/json": { schema: CreateOptionTypeBodySchema } },
+            required: true,
+        },
+    },
+    responses: {
+        201: { content: { "application/json": { schema: DataResponse } }, description: "Created" },
+        ...errorResponses,
+    },
+});
+export const createOptionValueRoute = createRoute({
+    method: "post",
+    path: "/options/{optionTypeId}/values",
+    tags: ["Catalog"],
+    summary: "Create an option value",
+    request: {
+        params: OptionTypeIdParam,
+        body: {
+            content: { "application/json": { schema: CreateOptionValueBodySchema } },
+            required: true,
+        },
+    },
+    responses: {
+        201: { content: { "application/json": { schema: DataResponse } }, description: "Created" },
+        ...errorResponses,
+    },
+});
+export const createVariantRoute = createRoute({
+    method: "post",
+    path: "/entities/{id}/variants",
+    tags: ["Catalog"],
+    summary: "Create a variant for an entity",
+    request: {
+        params: EntityIdParam,
+        body: {
+            content: { "application/json": { schema: CreateVariantBodySchema } },
+            required: true,
+        },
+    },
+    responses: {
+        201: { content: { "application/json": { schema: DataResponse } }, description: "Created" },
+        ...errorResponses,
+    },
+});
+export const generateVariantsRoute = createRoute({
+    method: "post",
+    path: "/entities/{id}/variants/generate",
+    tags: ["Catalog"],
+    summary: "Generate variants from option combinations",
+    request: {
+        params: EntityIdParam,
+        body: {
+            content: { "application/json": { schema: GenerateVariantsBodySchema } },
+            required: true,
+        },
+    },
+    responses: {
+        201: { content: { "application/json": { schema: DataResponse } }, description: "Generated" },
+        ...errorResponses,
+    },
+});

package/dist/interfaces/rest/schemas/checkout.d.ts

@@ -0,0 +1,160 @@
+import { z } from "@hono/zod-openapi";
+export declare const CheckoutBodySchema: z.ZodObject<{
+    cartId: z.ZodUUID;
+    paymentMethodId: z.ZodString;
+    customerId: z.ZodOptional<z.ZodString>;
+    customerGroupIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    currency: z.ZodOptional<z.ZodString>;
+    promotionCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    shippingAddress: z.ZodOptional<z.ZodObject<{
+        line1: z.ZodString;
+        line2: z.ZodOptional<z.ZodString>;
+        city: z.ZodString;
+        state: z.ZodOptional<z.ZodString>;
+        postalCode: z.ZodString;
+        country: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const OrderResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        id: z.ZodUUID;
+        orderNumber: z.ZodString;
+        status: z.ZodString;
+        currency: z.ZodString;
+        subtotal: z.ZodNumber;
+        taxTotal: z.ZodNumber;
+        shippingTotal: z.ZodNumber;
+        discountTotal: z.ZodNumber;
+        grandTotal: z.ZodNumber;
+        placedAt: z.ZodString;
+    }, z.core.$strip>;
+    meta: z.ZodOptional<z.ZodObject<{
+        hookErrors: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const checkoutRoute: {
+    method: "post";
+    path: "/";
+    tags: string[];
+    summary: string;
+    description: string;
+    request: {
+        body: {
+            content: {
+                "application/json": {
+                    schema: z.ZodObject<{
+                        cartId: z.ZodUUID;
+                        paymentMethodId: z.ZodString;
+                        customerId: z.ZodOptional<z.ZodString>;
+                        customerGroupIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        currency: z.ZodOptional<z.ZodString>;
+                        promotionCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        shippingAddress: z.ZodOptional<z.ZodObject<{
+                            line1: z.ZodString;
+                            line2: z.ZodOptional<z.ZodString>;
+                            city: z.ZodString;
+                            state: z.ZodOptional<z.ZodString>;
+                            postalCode: z.ZodString;
+                            country: z.ZodString;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>;
+                };
+            };
+            required: true;
+        };
+    };
+    responses: {
+        400: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Business logic error.";
+        };
+        401: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Authentication required.";
+        };
+        403: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Insufficient permissions.";
+        };
+        404: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Resource not found.";
+        };
+        422: {
+            readonly content: {
+                readonly "application/json": {
+                    readonly schema: z.ZodObject<{
+                        error: z.ZodObject<{
+                            code: z.ZodString;
+                            message: z.ZodString;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                };
+            };
+            readonly description: "Validation error.";
+        };
+        201: {
+            content: {
+                "application/json": {
+                    schema: z.ZodObject<{
+                        data: z.ZodObject<{
+                            id: z.ZodUUID;
+                            orderNumber: z.ZodString;
+                            status: z.ZodString;
+                            currency: z.ZodString;
+                            subtotal: z.ZodNumber;
+                            taxTotal: z.ZodNumber;
+                            shippingTotal: z.ZodNumber;
+                            discountTotal: z.ZodNumber;
+                            grandTotal: z.ZodNumber;
+                            placedAt: z.ZodString;
+                        }, z.core.$strip>;
+                        meta: z.ZodOptional<z.ZodObject<{
+                            hookErrors: z.ZodArray<z.ZodString>;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>;
+                };
+            };
+            description: string;
+        };
+    };
+} & {
+    getRoutingPath(): "/";
+};
+//# sourceMappingURL=checkout.d.ts.map

package/dist/interfaces/rest/schemas/checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/rest/schemas/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAe,MAAM,mBAAmB,CAAC;AAKnD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;iBAeF,CAAC;AAI9B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;iBAgBF,CAAC;AAI/B,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqBxB,CAAC"}

package/dist/interfaces/rest/schemas/checkout.js

@@ -0,0 +1,60 @@
+import { z, createRoute } from "@hono/zod-openapi";
+import { errorResponses } from "./shared.js";
+// ─── Request Schema ──────────────────────────────────────────────────────────
+export const CheckoutBodySchema = z.object({
+    cartId: z.uuid().openapi({ example: "550e8400-e29b-41d4-a716-446655440000" }),
+    paymentMethodId: z.string().openapi({ example: "pm_card_visa" }),
+    customerId: z.string().optional().openapi({ example: "customer-uuid-or-user-id" }),
+    customerGroupIds: z.array(z.string()).optional(),
+    currency: z.string().length(3).optional().openapi({ example: "USD" }),
+    promotionCodes: z.array(z.string()).optional().openapi({ example: ["SUMMER10"] }),
+    shippingAddress: z.object({
+        line1: z.string(),
+        line2: z.string().optional(),
+        city: z.string(),
+        state: z.string().optional(),
+        postalCode: z.string(),
+        country: z.string(),
+    }).optional(),
+}).openapi("CheckoutRequest");
+// ─── Response Schema ─────────────────────────────────────────────────────────
+export const OrderResponseSchema = z.object({
+    data: z.object({
+        id: z.uuid(),
+        orderNumber: z.string(),
+        status: z.string(),
+        currency: z.string(),
+        subtotal: z.number(),
+        taxTotal: z.number(),
+        shippingTotal: z.number(),
+        discountTotal: z.number(),
+        grandTotal: z.number(),
+        placedAt: z.string(),
+    }),
+    meta: z.object({
+        hookErrors: z.array(z.string()),
+    }).optional(),
+}).openapi("CheckoutResponse");
+// ─── Route Definition ────────────────────────────────────────────────────────
+export const checkoutRoute = createRoute({
+    method: "post",
+    path: "/",
+    tags: ["Checkout"],
+    summary: "Process checkout and create an order",
+    description: "Validates cart, reserves inventory, authorizes payment, calculates tax/shipping, and creates the order.",
+    request: {
+        body: {
+            content: {
+                "application/json": { schema: CheckoutBodySchema },
+            },
+            required: true,
+        },
+    },
+    responses: {
+        201: {
+            content: { "application/json": { schema: OrderResponseSchema } },
+            description: "Order created successfully.",
+        },
+        ...errorResponses,
+    },
+});