@deliverart/sdk-js-order 0.0.1

package/src/requests/bundles/GetBundles.ts

@@ -0,0 +1,46 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import {
+  createPaginatedSchema,
+  Paginated,
+  responseToPagination,
+} from '@deliverart/sdk-js-global-types'
+import { AxiosResponse } from 'axios'
+import { z } from 'zod'
+
+import { Bundle, bundleSchema, BundlesQueryParams, bundlesQuerySchema } from '../../models'
+
+export const getBundlesQuerySchema = bundlesQuerySchema
+export type GetBundlesQueryParams = z.infer<typeof getBundlesQuerySchema>
+
+export const getBundlesResponseSchema = createPaginatedSchema(bundleSchema)
+export type GetBundlesResponse = z.infer<typeof getBundlesResponseSchema>
+
+export const getBundlesInputSchema = z.undefined()
+
+export class GetBundles extends AbstractApiRequest<
+  void,
+  GetBundlesResponse,
+  GetBundlesQueryParams
+> {
+  readonly method = 'GET'
+  readonly contentType = 'application/json'
+  readonly accept = 'application/json'
+
+  readonly inputSchema = getBundlesInputSchema
+  readonly outputSchema = getBundlesResponseSchema
+  readonly querySchema = getBundlesQuerySchema
+  readonly headersSchema = undefined
+
+  constructor(options?: { query?: BundlesQueryParams }) {
+    super(undefined, options)
+  }
+
+  getPath(): string {
+    return '/bundles'
+  }
+
+  parseResponse(data: unknown, rawResponse: AxiosResponse): Paginated<Bundle> {
+    const bundles = z.array(bundleSchema).parse(data)
+    return this.validateOutput({ data: bundles, pagination: responseToPagination(rawResponse) })
+  }
+}

package/src/requests/bundles/UpdateBundle.ts

@@ -0,0 +1,36 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import { z } from 'zod'
+
+import { BundleDetails, bundleDetailsSchema, writableBundleSchema } from '../../models'
+
+export const updateBundleInputSchema = writableBundleSchema
+  .omit({
+    pointOfSale: true,
+  })
+  .partial()
+export type UpdateBundleInput = z.infer<typeof updateBundleInputSchema>
+
+export const updateBundleResponseSchema = bundleDetailsSchema
+export type UpdateBundleResponse = BundleDetails
+
+export class UpdateBundle extends AbstractApiRequest<UpdateBundleInput, UpdateBundleResponse> {
+  readonly method = 'PATCH'
+  readonly contentType = 'application/merge-patch+json'
+  readonly accept = 'application/json'
+
+  readonly inputSchema = updateBundleInputSchema
+  readonly outputSchema = updateBundleResponseSchema
+  readonly querySchema = undefined
+  readonly headersSchema = undefined
+
+  private readonly bundleId: string
+
+  constructor(bundleId: string, input: UpdateBundleInput) {
+    super(input)
+    this.bundleId = bundleId
+  }
+
+  getPath(): string {
+    return `/bundles/${this.bundleId}`
+  }
+}

package/src/requests/bundles/index.ts

@@ -0,0 +1,5 @@
+export * from './CreateBundle'
+export * from './DeleteBundle'
+export * from './GetBundleDetails'
+export * from './GetBundles'
+export * from './UpdateBundle'

package/src/requests/index.ts

@@ -0,0 +1,4 @@
+export * from './bundles'
+export * from './order-menu-item-modifiers'
+export * from './order-menu-items'
+export * from './orders'

package/src/requests/order-menu-item-modifiers/GetOrderMenuItemModifierDetails.ts

@@ -0,0 +1,33 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import { z } from 'zod'
+
+import { OrderMenuItemModifierDetails, orderMenuItemModifierDetailsSchema } from '../../models'
+
+export const getOrderMenuItemModifierDetailsInputSchema = z.undefined()
+
+export const getOrderMenuItemModifierDetailsResponseSchema = orderMenuItemModifierDetailsSchema
+export type GetOrderMenuItemModifierDetailsResponse = OrderMenuItemModifierDetails
+
+export class GetOrderMenuItemModifierModifierDetails extends AbstractApiRequest<
+  void,
+  GetOrderMenuItemModifierDetailsResponse
+> {
+  readonly method = 'GET'
+  readonly contentType = 'application/json'
+  readonly accept = 'application/json'
+  readonly inputSchema = getOrderMenuItemModifierDetailsInputSchema
+  readonly outputSchema = getOrderMenuItemModifierDetailsResponseSchema
+  readonly querySchema = undefined
+  readonly headersSchema = undefined
+
+  private readonly orderMenuItemModifierId: string
+
+  constructor(orderMenuItemModifierId: string) {
+    super()
+    this.orderMenuItemModifierId = orderMenuItemModifierId
+  }
+
+  getPath(): string {
+    return `/orders/menu_items/modifiers/${this.orderMenuItemModifierId}`
+  }
+}

package/src/requests/order-menu-item-modifiers/GetOrderMenuItemModifiers.ts

@@ -0,0 +1,60 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import {
+  createPaginatedSchema,
+  Paginated,
+  responseToPagination,
+} from '@deliverart/sdk-js-global-types'
+import { AxiosResponse } from 'axios'
+import { z } from 'zod'
+
+import {
+  OrderMenuItemModifier,
+  orderMenuItemModifierSchema,
+  OrderMenuItemModifiersQueryParams,
+  orderMenuItemModifiersQuerySchema,
+} from '../../models'
+
+export const getOrderMenuItemModifiersQuerySchema = orderMenuItemModifiersQuerySchema
+export type GetOrderMenuItemModifiersQueryParams = z.infer<
+  typeof getOrderMenuItemModifiersQuerySchema
+>
+
+export const getOrderMenuItemModifiersResponseSchema = createPaginatedSchema(
+  orderMenuItemModifierSchema,
+)
+export type GetOrderMenuItemModifiersResponse = z.infer<
+  typeof getOrderMenuItemModifiersResponseSchema
+>
+
+export const getOrderMenuItemModifiersInputSchema = z.undefined()
+
+export class GetOrderMenuItemModifierMenuItemModifiers extends AbstractApiRequest<
+  void,
+  GetOrderMenuItemModifiersResponse,
+  GetOrderMenuItemModifiersQueryParams
+> {
+  readonly method = 'GET'
+  readonly contentType = 'application/json'
+  readonly accept = 'application/json'
+
+  readonly inputSchema = getOrderMenuItemModifiersInputSchema
+  readonly outputSchema = getOrderMenuItemModifiersResponseSchema
+  readonly querySchema = getOrderMenuItemModifiersQuerySchema
+  readonly headersSchema = undefined
+
+  constructor(options?: { query?: OrderMenuItemModifiersQueryParams }) {
+    super(undefined, options)
+  }
+
+  getPath(): string {
+    return '/orders/menu_items/modifiers'
+  }
+
+  parseResponse(data: unknown, rawResponse: AxiosResponse): Paginated<OrderMenuItemModifier> {
+    const orderMenuItemModifiers = z.array(orderMenuItemModifierSchema).parse(data)
+    return this.validateOutput({
+      data: orderMenuItemModifiers,
+      pagination: responseToPagination(rawResponse),
+    })
+  }
+}

package/src/requests/order-menu-item-modifiers/index.ts

@@ -0,0 +1,2 @@
+export * from './GetOrderMenuItemModifierDetails'
+export * from './GetOrderMenuItemModifiers'

package/src/requests/order-menu-items/GetOrderMenuItemDetails.ts

@@ -0,0 +1,33 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import { z } from 'zod'
+
+import { OrderMenuItemDetails, orderMenuItemDetailsSchema } from '../../models'
+
+export const getOrderMenuItemDetailsInputSchema = z.undefined()
+
+export const getOrderMenuItemDetailsResponseSchema = orderMenuItemDetailsSchema
+export type GetOrderMenuItemDetailsResponse = OrderMenuItemDetails
+
+export class GetOrderMenuItemDetails extends AbstractApiRequest<
+  void,
+  GetOrderMenuItemDetailsResponse
+> {
+  readonly method = 'GET'
+  readonly contentType = 'application/json'
+  readonly accept = 'application/json'
+  readonly inputSchema = getOrderMenuItemDetailsInputSchema
+  readonly outputSchema = getOrderMenuItemDetailsResponseSchema
+  readonly querySchema = undefined
+  readonly headersSchema = undefined
+
+  private readonly orderMenuItemId: string
+
+  constructor(orderMenuItemId: string) {
+    super()
+    this.orderMenuItemId = orderMenuItemId
+  }
+
+  getPath(): string {
+    return `/orders/menu_items/${this.orderMenuItemId}`
+  }
+}

package/src/requests/order-menu-items/GetOrderMenuItems.ts

@@ -0,0 +1,54 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import {
+  createPaginatedSchema,
+  Paginated,
+  responseToPagination,
+} from '@deliverart/sdk-js-global-types'
+import { AxiosResponse } from 'axios'
+import { z } from 'zod'
+
+import {
+  OrderMenuItem,
+  orderMenuItemSchema,
+  OrderMenuItemsQueryParams,
+  orderMenuItemsQuerySchema,
+} from '../../models'
+
+export const getOrderMenuItemsQuerySchema = orderMenuItemsQuerySchema
+export type GetOrderMenuItemsQueryParams = z.infer<typeof getOrderMenuItemsQuerySchema>
+
+export const getOrderMenuItemsResponseSchema = createPaginatedSchema(orderMenuItemSchema)
+export type GetOrderMenuItemsResponse = z.infer<typeof getOrderMenuItemsResponseSchema>
+
+export const getOrderMenuItemsInputSchema = z.undefined()
+
+export class GetOrderMenuItemMenuItems extends AbstractApiRequest<
+  void,
+  GetOrderMenuItemsResponse,
+  GetOrderMenuItemsQueryParams
+> {
+  readonly method = 'GET'
+  readonly contentType = 'application/json'
+  readonly accept = 'application/json'
+
+  readonly inputSchema = getOrderMenuItemsInputSchema
+  readonly outputSchema = getOrderMenuItemsResponseSchema
+  readonly querySchema = getOrderMenuItemsQuerySchema
+  readonly headersSchema = undefined
+
+  constructor(options?: { query?: OrderMenuItemsQueryParams }) {
+    super(undefined, options)
+  }
+
+  getPath(): string {
+    return '/orders/menu_items'
+  }
+
+  parseResponse(data: unknown, rawResponse: AxiosResponse): Paginated<OrderMenuItem> {
+    const orderMenuItems = z.array(orderMenuItemSchema).parse(data)
+    return this.validateOutput({
+      data: orderMenuItems,
+      pagination: responseToPagination(rawResponse),
+    })
+  }
+}

package/src/requests/order-menu-items/index.ts

@@ -0,0 +1,2 @@
+export * from './GetOrderMenuItemDetails'
+export * from './GetOrderMenuItems'

package/src/requests/orders/AdvanceOrderPreparationStatus.ts

@@ -0,0 +1,33 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import { z } from 'zod'
+
+import { OrderDetails, orderDetailsSchema } from '../../models'
+
+export const advanceOrderPreparationStatusInputSchema = z.undefined()
+
+export const advanceOrderPreparationStatusResponseSchema = orderDetailsSchema
+export type AdvanceOrderPreparationStatusResponse = OrderDetails
+
+export class AdvanceOrderPreparationStatus extends AbstractApiRequest<
+  void,
+  AdvanceOrderPreparationStatusResponse
+> {
+  readonly method = 'POST'
+  readonly contentType = 'application/json'
+  readonly accept = 'application/json'
+  readonly inputSchema = advanceOrderPreparationStatusInputSchema
+  readonly outputSchema = advanceOrderPreparationStatusResponseSchema
+  readonly querySchema = undefined
+  readonly headersSchema = undefined
+
+  private readonly orderId: string
+
+  constructor(orderId: string) {
+    super()
+    this.orderId = orderId
+  }
+
+  getPath(): string {
+    return `/orders/${this.orderId}/preparation/advance`
+  }
+}

package/src/requests/orders/ConfirmOrder.ts

@@ -0,0 +1,30 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import { z } from 'zod'
+
+import { OrderDetails, orderDetailsSchema } from '../../models'
+
+export const confirmOrderInputSchema = z.undefined()
+
+export const confirmOrderResponseSchema = orderDetailsSchema
+export type ConfirmOrderResponse = OrderDetails
+
+export class ConfirmOrder extends AbstractApiRequest<void, ConfirmOrderResponse> {
+  readonly method = 'POST'
+  readonly contentType = 'application/json'
+  readonly accept = 'application/json'
+  readonly inputSchema = confirmOrderInputSchema
+  readonly outputSchema = confirmOrderResponseSchema
+  readonly querySchema = undefined
+  readonly headersSchema = undefined
+
+  private readonly orderId: string
+
+  constructor(orderId: string) {
+    super()
+    this.orderId = orderId
+  }
+
+  getPath(): string {
+    return `/orders/${this.orderId}/confirm`
+  }
+}

package/src/requests/orders/CreateOrder.ts

@@ -0,0 +1,48 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import { z } from 'zod'
+
+import { OrderDetails, orderDetailsSchema, writableOrderSchema } from '../../models'
+
+export const createOrderInputSchema = writableOrderSchema.required().partial({
+  customer: true,
+  customerBusinessProfile: true,
+  referenceBundle: true,
+  partner: true,
+  partnerIdentifier: true,
+  displayId: true,
+  autoAccept: true,
+  customerInfo: true,
+  billingInfo: true,
+  address: true,
+  preparationStatus: true,
+  preparationTime: true,
+  deliveryTime: true,
+  collectionTime: true,
+  discount: true,
+  notes: true,
+  deliveryNotes: true,
+  kitchenNotes: true,
+})
+export type CreateOrderInput = z.infer<typeof createOrderInputSchema>
+
+export const createOrderResponseSchema = orderDetailsSchema
+export type CreateOrderResponse = OrderDetails
+
+export class CreateOrder extends AbstractApiRequest<CreateOrderInput, CreateOrderResponse> {
+  readonly method = 'POST'
+  readonly contentType = 'application/json'
+  readonly accept = 'application/json'
+
+  readonly inputSchema = createOrderInputSchema
+  readonly outputSchema = createOrderResponseSchema
+  readonly querySchema = undefined
+  readonly headersSchema = undefined
+
+  constructor(input: CreateOrderInput) {
+    super(input)
+  }
+
+  getPath(): string {
+    return '/orders'
+  }
+}

package/src/requests/orders/DeleteOrder.ts

@@ -0,0 +1,27 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import { z } from 'zod'
+
+export const deleteOrderInputSchema = z.undefined()
+export const deleteOrderResponseSchema = z.undefined()
+
+export class DeleteOrder extends AbstractApiRequest<void, void> {
+  readonly method = 'DELETE'
+  readonly contentType = 'application/json'
+  readonly accept = 'application/json'
+
+  readonly inputSchema = deleteOrderInputSchema
+  readonly outputSchema = deleteOrderResponseSchema
+  readonly querySchema = undefined
+  readonly headersSchema = undefined
+
+  private readonly orderId: string
+
+  constructor(orderId: string) {
+    super()
+    this.orderId = orderId
+  }
+
+  getPath(): string {
+    return `/orders/${this.orderId}`
+  }
+}

package/src/requests/orders/GetOrderDetails.ts

@@ -0,0 +1,30 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import { z } from 'zod'
+
+import { OrderDetails, orderDetailsSchema } from '../../models'
+
+export const getOrderDetailsInputSchema = z.undefined()
+
+export const getOrderDetailsResponseSchema = orderDetailsSchema
+export type GetOrderDetailsResponse = OrderDetails
+
+export class GetOrderDetails extends AbstractApiRequest<void, GetOrderDetailsResponse> {
+  readonly method = 'GET'
+  readonly contentType = 'application/json'
+  readonly accept = 'application/json'
+  readonly inputSchema = getOrderDetailsInputSchema
+  readonly outputSchema = getOrderDetailsResponseSchema
+  readonly querySchema = undefined
+  readonly headersSchema = undefined
+
+  private readonly orderId: string
+
+  constructor(orderId: string) {
+    super()
+    this.orderId = orderId
+  }
+
+  getPath(): string {
+    return `/orders/${this.orderId}`
+  }
+}

package/src/requests/orders/GetOrders.ts

@@ -0,0 +1,42 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import {
+  createPaginatedSchema,
+  Paginated,
+  responseToPagination,
+} from '@deliverart/sdk-js-global-types'
+import { AxiosResponse } from 'axios'
+import { z } from 'zod'
+
+import { Order, orderSchema, OrdersQueryParams, ordersQuerySchema } from '../../models'
+
+export const getOrdersQuerySchema = ordersQuerySchema
+export type GetOrdersQueryParams = z.infer<typeof getOrdersQuerySchema>
+
+export const getOrdersResponseSchema = createPaginatedSchema(orderSchema)
+export type GetOrdersResponse = z.infer<typeof getOrdersResponseSchema>
+
+export const getOrdersInputSchema = z.undefined()
+
+export class GetOrders extends AbstractApiRequest<void, GetOrdersResponse, GetOrdersQueryParams> {
+  readonly method = 'GET'
+  readonly contentType = 'application/json'
+  readonly accept = 'application/json'
+
+  readonly inputSchema = getOrdersInputSchema
+  readonly outputSchema = getOrdersResponseSchema
+  readonly querySchema = getOrdersQuerySchema
+  readonly headersSchema = undefined
+
+  constructor(options?: { query?: OrdersQueryParams }) {
+    super(undefined, options)
+  }
+
+  getPath(): string {
+    return '/orders'
+  }
+
+  parseResponse(data: unknown, rawResponse: AxiosResponse): Paginated<Order> {
+    const orders = z.array(orderSchema).parse(data)
+    return this.validateOutput({ data: orders, pagination: responseToPagination(rawResponse) })
+  }
+}

package/src/requests/orders/UpdateOrder.ts

@@ -0,0 +1,42 @@
+import { AbstractApiRequest } from '@deliverart/sdk-js-core'
+import { z } from 'zod'
+
+import { OrderDetails, orderDetailsSchema, writableOrderSchema } from '../../models'
+
+export const updateOrderInputSchema = writableOrderSchema
+  .omit({
+    pointOfSale: true,
+    type: true,
+    source: true,
+    partner: true,
+    partnerIdentifier: true,
+    displayId: true,
+    autoAccept: true,
+  })
+  .partial()
+export type UpdateOrderInput = z.infer<typeof updateOrderInputSchema>
+
+export const updateOrderResponseSchema = orderDetailsSchema
+export type UpdateOrderResponse = OrderDetails
+
+export class UpdateOrder extends AbstractApiRequest<UpdateOrderInput, UpdateOrderResponse> {
+  readonly method = 'PATCH'
+  readonly contentType = 'application/merge-patch+json'
+  readonly accept = 'application/json'
+
+  readonly inputSchema = updateOrderInputSchema
+  readonly outputSchema = updateOrderResponseSchema
+  readonly querySchema = undefined
+  readonly headersSchema = undefined
+
+  private readonly orderId: string
+
+  constructor(orderId: string, input: UpdateOrderInput) {
+    super(input)
+    this.orderId = orderId
+  }
+
+  getPath(): string {
+    return `/orders/${this.orderId}`
+  }
+}

package/src/requests/orders/index.ts

@@ -0,0 +1,7 @@
+export * from './AdvanceOrderPreparationStatus'
+export * from './ConfirmOrder'
+export * from './CreateOrder'
+export * from './DeleteOrder'
+export * from './GetOrderDetails'
+export * from './GetOrders'
+export * from './UpdateOrder'

package/src/types.ts

@@ -0,0 +1,119 @@
+import { z } from 'zod'
+
+export const orderTypes = ['delivery', 'take_away', 'kitchen'] as const
+export const orderTypeSchema = z.enum(orderTypes)
+export type OrderType = z.infer<typeof orderTypeSchema>
+
+export const orderSources = ['application', 'ecommerce', 'other'] as const
+export const orderSourceSchema = z.enum(orderSources)
+export type OrderSource = z.infer<typeof orderSourceSchema>
+
+export const orderStatuses = ['pending', 'confirmed', 'rejected'] as const
+export const orderStatusSchema = z.enum(orderStatuses)
+export type OrderStatus = z.infer<typeof orderStatusSchema>
+
+export const orderPreparationStatuses = ['to_prepare', 'in_preparation', 'done'] as const
+export const orderPreparationStatusSchema = z.enum(orderPreparationStatuses)
+export type OrderPreparationStatus = z.infer<typeof orderPreparationStatusSchema>
+
+export const orderMenuItemActions = ['add', 'remove'] as const
+export const orderMenuItemActionSchema = z.enum(orderMenuItemActions)
+export type OrderMenuItemAction = z.infer<typeof orderMenuItemActionSchema>
+
+export const bundleStatuses = ['pending', 'busy', 'broken', 'released'] as const
+export const bundleStatusSchema = z.enum(bundleStatuses)
+export type BundleStatus = z.infer<typeof bundleStatusSchema>
+
+export const bundleTypes = ['REGULAR', 'FORCED'] as const
+export const bundleTypeSchema = z.enum(bundleTypes)
+export type BundleType = z.infer<typeof bundleTypeSchema>
+
+export const bundleBundleBrokenReasons = ['delivery_removed'] as const
+export const bundleBundleBrokenReasonSchema = z.enum(bundleBundleBrokenReasons)
+export type BundleBundleBrokenReason = z.infer<typeof bundleBundleBrokenReasonSchema>
+
+export const orderPathSchema = z
+  .string()
+  .refine(val => /^\/orders\/[a-z_]+\/[0-9a-fA-F-]{36}$/.test(val), {
+    message: 'Invalid order path format',
+  })
+export type OrderPath = z.infer<typeof orderPathSchema>
+
+export const orderNullablePathSchema = z
+  .string()
+  .nullable()
+  .refine(
+    val => {
+      if (!val) return true
+      return /^\/orders\/[a-z_]+\/[0-9a-fA-F-]{36}$/.test(val)
+    },
+    {
+      message: 'Invalid order path format',
+    },
+  )
+export type OrderNullablePath = z.infer<typeof orderNullablePathSchema>
+
+export const orderMenuItemPathSchema = z
+  .string()
+  .refine(val => /^\/orders\/menu_items\/[a-z_]+\/[0-9a-fA-F-]{36}$/.test(val), {
+    message: 'Invalid order menu item path format',
+  })
+export type OrderMenuItemPath = z.infer<typeof orderMenuItemPathSchema>
+
+export const orderMenuItemNullablePathSchema = z
+  .string()
+  .nullable()
+  .refine(
+    val => {
+      if (!val) return true
+      return /^\/orders\/menu_items\/[a-z_]+\/[0-9a-fA-F-]{36}$/.test(val)
+    },
+    {
+      message: 'Invalid order menu item path format',
+    },
+  )
+export type OrderMenuItemNullablePath = z.infer<typeof orderMenuItemNullablePathSchema>
+
+export const orderMenuItemModifierPathSchema = z
+  .string()
+  .refine(val => /^\/orders\/menu_items\/modifiers\/[a-z_]+\/[0-9a-fA-F-]{36}$/.test(val), {
+    message: 'Invalid order menu item modifier path format',
+  })
+export type OrderMenuItemModifierPath = z.infer<typeof orderMenuItemModifierPathSchema>
+
+export const orderMenuItemModifierNullablePathSchema = z
+  .string()
+  .nullable()
+  .refine(
+    val => {
+      if (!val) return true
+      return /^\/orders\/menu_items\/modifiers\/[a-z_]+\/[0-9a-fA-F-]{36}$/.test(val)
+    },
+    {
+      message: 'Invalid order menu item modifier path format',
+    },
+  )
+export type OrderMenuItemModifierNullablePath = z.infer<
+  typeof orderMenuItemModifierNullablePathSchema
+>
+
+export const bundlePathSchema = z
+  .string()
+  .refine(val => /^\/bundles\/[a-z_]+\/[0-9a-fA-F-]{36}$/.test(val), {
+    message: 'Invalid bundle path format',
+  })
+export type BundlePath = z.infer<typeof bundlePathSchema>
+
+export const bundleNullablePathSchema = z
+  .string()
+  .nullable()
+  .refine(
+    val => {
+      if (!val) return true
+      return /^\/bundles\/[a-z_]+\/[0-9a-fA-F-]{36}$/.test(val)
+    },
+    {
+      message: 'Invalid bundle path format',
+    },
+  )
+export type BundleNullablePath = z.infer<typeof bundleNullablePathSchema>