@meeovi/layer-shared 1.0.0 → 1.0.2

package/app/composables/mappers/createMapper.ts

@@ -0,0 +1,11 @@
+import { MapperDefinition, MapperFn } from './types'
+
+export function createMapper<TInput, TOutput>(
+  name: string,
+  fn: MapperFn<TInput, TOutput>
+): MapperDefinition<TInput, TOutput> {
+  return {
+    name,
+    map: fn
+  }
+}

package/app/composables/mappers/errors.ts

@@ -0,0 +1,13 @@
+export class MapperError extends Error {
+  constructor(message: string) {
+    super(message)
+    this.name = 'MapperError'
+  }
+}
+
+export class MapperNotFoundError extends MapperError {
+  constructor(name: string) {
+    super(`Mapper "${name}" was not found`)
+    this.name = 'MapperNotFoundError'
+  }
+}

package/app/composables/mappers/index.ts

@@ -0,0 +1,7 @@
+// /packages/mapper-core/index.ts
+export * from './types'
+export * from './errors'
+export * from './createMapper'
+export * from './registry'
+export * from './zodMapper'
+export * from './testHarness'

package/app/composables/mappers/registry.ts

@@ -0,0 +1,28 @@
+import { MapperDefinition } from './types'
+import { MapperNotFoundError } from './errors'
+
+const registry = new Map<string, MapperDefinition<any, any>>()
+
+export function registerMapper<TInput, TOutput>(
+  mapper: MapperDefinition<TInput, TOutput>
+) {
+  registry.set(mapper.name, mapper)
+}
+
+export function getMapper<TInput, TOutput>(
+  name: string
+): MapperDefinition<TInput, TOutput> {
+  const mapper = registry.get(name)
+  if (!mapper) {
+    throw new MapperNotFoundError(name)
+  }
+  return mapper
+}
+
+export function hasMapper(name: string): boolean {
+  return registry.has(name)
+}
+
+export function listMappers(): string[] {
+  return Array.from(registry.keys())
+}

package/app/composables/mappers/testHarness.ts

@@ -0,0 +1,142 @@
+import { MapperDefinition } from './types'
+import { MapperError } from './errors'
+
+export interface MapperTestCase<TInput, TOutput> {
+  name: string
+  input: TInput
+  expected: TOutput | ((output: TOutput) => void | Promise<void>)
+  snapshot?: boolean
+}
+
+export interface MapperTestOptions<TInput, TOutput> {
+  mapper: MapperDefinition<TInput, TOutput>
+  cases: MapperTestCase<TInput, TOutput>[]
+  async?: boolean
+}
+
+export async function runMapperTests<TInput, TOutput>(
+  options: MapperTestOptions<TInput, TOutput>
+) {
+  const { mapper, cases } = options
+
+  for (const testCase of cases) {
+    const { name, input, expected, snapshot } = testCase
+
+    try {
+      const result = await maybeAsync(mapper.map, input)
+
+      // Snapshot mode (stringified)
+      if (snapshot) {
+        const snap = JSON.stringify(result, null, 2)
+        console.log(`\n📸 Snapshot for "${mapper.name}" → "${name}":\n${snap}\n`)
+      }
+
+      // Function-based expectation
+      if (isExpectedFunction<TOutput>(expected)) {
+        await expected(result)
+        continue
+      }
+
+      // Deep equality check
+      const pass = deepEqual(result, expected)
+      if (!pass) {
+        throw new MapperError(
+          `Mapper "${mapper.name}" test "${name}" failed.\n` +
+            diffString(expected, result)
+        )
+      }
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new MapperError(
+          `Mapper "${mapper.name}" test "${name}" threw an error:\n${error.message}`
+        )
+      }
+      throw error
+    }
+  }
+}
+
+/* -------------------------------------------------------
+   Helpers
+------------------------------------------------------- */
+
+async function maybeAsync<TInput, TOutput>(
+  fn: (input: TInput) => TOutput | Promise<TOutput>,
+  input: TInput
+): Promise<TOutput> {
+  return await fn(input)
+}
+
+function isExpectedFunction<TOutput>(
+  value: unknown
+): value is (output: TOutput) => void | Promise<void> {
+  return typeof value === 'function'
+}
+
+function deepEqual(a: unknown, b: unknown): boolean {
+  if (Object.is(a, b)) return true
+
+  if (
+    typeof a !== 'object' ||
+    typeof b !== 'object' ||
+    a === null ||
+    b === null
+  ) {
+    return false
+  }
+
+  const aKeys = Object.keys(a as object)
+  const bKeys = Object.keys(b as object)
+  if (aKeys.length !== bKeys.length) return false
+
+  for (const key of aKeys) {
+    if (!deepEqual((a as any)[key], (b as any)[key])) return false
+  }
+
+  return true
+}
+
+/**
+ * Pretty diff output (no deps)
+ */
+function diffString(expected: unknown, received: unknown): string {
+  const exp = JSON.stringify(expected, null, 2)
+  const rec = JSON.stringify(received, null, 2)
+
+  return (
+    `\nExpected:\n${indent(exp)}\n\nReceived:\n${indent(rec)}\n` +
+    `\nDiff:\n${indent(generateDiff(exp, rec))}`
+  )
+}
+
+function indent(str: string): string {
+  return str
+    .split('\n')
+    .map((line) => `  ${line}`)
+    .join('\n')
+}
+
+/**
+ * Minimal diff generator (line-by-line)
+ */
+function generateDiff(a: string, b: string): string {
+  const aLines = a.split('\n')
+  const bLines = b.split('\n')
+  const max = Math.max(aLines.length, bLines.length)
+
+  const diff: string[] = []
+
+  for (let i = 0; i < max; i++) {
+    const left = aLines[i]
+    const right = bLines[i]
+
+    if (left === right) {
+      diff.push(`  ${left ?? ''}`)
+    } else {
+      if (left !== undefined) diff.push(`- ${left}`)
+      if (right !== undefined) diff.push(`+ ${right}`)
+    }
+  }
+
+  return diff.join('\n')
+}

package/app/composables/mappers/types.ts

@@ -0,0 +1,6 @@
+export type MapperFn<TInput, TOutput> = (input: TInput) => TOutput
+
+export interface MapperDefinition<TInput, TOutput> {
+  name: string
+  map: MapperFn<TInput, TOutput>
+}

package/app/composables/mappers/zodMapper.ts

@@ -0,0 +1,37 @@
+import type { ZodSchema } from 'zod'
+import type { MapperDefinition, MapperFn } from './types'
+import { createMapper } from './createMapper'
+import { MapperError } from './errors'
+
+export interface ZodMapperOptions<TInput, TOutput> {
+  name: string
+  inputSchema: ZodSchema<TInput>
+  outputSchema: ZodSchema<TOutput>
+  map: MapperFn<TInput, TOutput>
+}
+
+export function createZodMapper<TInput, TOutput>(
+  options: ZodMapperOptions<TInput, TOutput>
+): MapperDefinition<TInput, TOutput> {
+  const { name, inputSchema, outputSchema, map } = options
+
+  return createMapper<TInput, TOutput>(name, (rawInput) => {
+    const parsedInput = inputSchema.safeParse(rawInput)
+    if (!parsedInput.success) {
+      throw new MapperError(
+        `Mapper "${name}" input validation failed: ${parsedInput.error.message}`
+      )
+    }
+
+    const output = map(parsedInput.data)
+
+    const parsedOutput = outputSchema.safeParse(output)
+    if (!parsedOutput.success) {
+      throw new MapperError(
+        `Mapper "${name}" output validation failed: ${parsedOutput.error.message}`
+      )
+    }
+
+    return parsedOutput.data
+  })
+}

package/app/composables/schema/commerce/attributes.ts

@@ -0,0 +1,10 @@
+export interface MeeoviAttribute {
+	id: number
+	default_label?: string | null
+	isPublic?: boolean | null
+	options?: Record<string, unknown> | null
+	attribute_code?: string | null
+	// relations omitted: attributes_product_types[], attributes_products[], integrations_attributes[], product_attributes[], products_attributes[], videos[]
+}
+
+

package/app/composables/schema/commerce/blocks.ts

@@ -0,0 +1,7 @@
+export interface MeeoviBlock {
+	id: string
+	type: string
+	content: string | null
+	metadata?: Record<string, unknown>
+}
+

package/app/composables/schema/commerce/bundleProduts.ts

@@ -0,0 +1,12 @@
+import { MeeoviProduct } from './product'
+
+export interface MeeoviBundleProduct {
+	id: string
+	title: string
+	items: MeeoviProduct[]
+	price: number
+	currency: string
+	stock: number | null
+	metadata?: Record<string, unknown>
+}
+

package/app/composables/schema/commerce/cart.ts

@@ -0,0 +1,35 @@
+import { MeeoviProduct } from './product'
+
+export interface MeeoviCartItem {
+	id: number
+	quantity?: number | null
+	metadata?: Record<string, unknown> | null
+	products?: string | null
+	cart?: number | null
+	product_id?: string | null
+	price?: number | null
+	total?: number | null
+	variant_id?: string | null
+	variant?: string | null
+}
+
+export interface MeeoviCart {
+	id: number
+	date_created?: string | null
+	user_updated?: string | null
+	date_updated?: string | null
+	session_id?: string | null
+	total_price?: number | null
+	user?: string | null
+	status?: string | null
+	subtotal?: number | null
+	tax_amount?: number | null
+	shipping_amount?: number | null
+	discount_amount?: number | null
+	total?: number | null
+	currency?: string | null
+	coupon_code?: string | null
+	// relations omitted: address_cart[], cart_cart_items[], cart_items[], cart_products[]
+}
+
+

package/app/composables/schema/commerce/category.ts

@@ -0,0 +1,15 @@
+export interface MeeoviCategory {
+	id: number
+	name?: string | null
+	description?: string | null
+	content?: string | null
+	image?: string | null
+	menus?: Record<string, unknown> | null
+	uid?: string | null
+	color?: string | null
+	colortext?: string | null
+	slug?: string | null
+	// relations omitted: articles_categories[], brands_categories[], ...
+}
+
+

package/app/composables/schema/commerce/checkout.ts

@@ -0,0 +1,11 @@
+import { MeeoviCart } from './cart'
+
+export interface MeeoviCheckout {
+	id: string
+	cart: MeeoviCart
+	total: number
+	currency: string
+	status: 'pending' | 'completed' | 'failed' | string
+	metadata?: Record<string, unknown>
+}
+

package/app/composables/schema/commerce/company.ts

@@ -0,0 +1,8 @@
+export interface MeeoviCompany {
+	id: string
+	name: string
+	website?: string | null
+	description?: string | null
+	metadata?: Record<string, unknown>
+}
+

package/app/composables/schema/commerce/configurableProducts.ts

@@ -0,0 +1,11 @@
+import { MeeoviProduct } from './product'
+
+export interface MeeoviConfigurableProduct {
+	id: string
+	baseProductId: string
+	title?: string | null
+	options: { name: string; values: string[] }[]
+	variants: MeeoviProduct[]
+	metadata?: Record<string, unknown>
+}
+

package/app/composables/schema/commerce/coupons.ts

@@ -0,0 +1,10 @@
+export interface MeeoviCoupon {
+	id: string
+	code: string
+	description?: string | null
+	discountType: 'percentage' | 'fixed' | string
+	amount: number
+	expiresAt?: string | null
+	metadata?: Record<string, unknown>
+}
+

package/app/composables/schema/commerce/credit-memos.ts

@@ -0,0 +1,50 @@
+export interface MeeoviCreditMemo {
+	id: number
+	created_at?: string | null
+	updated_at?: string | null
+	adjustment?: number | null
+	adjustment_negative?: number | null
+	adjustment_positive?: number | null
+	base_adjustment?: number | null
+	base_adjustment_negative?: number | null
+	base_adjustment_positive?: number | null
+	base_currency_code?: string | null
+	base_discount_amount?: number | null
+	base_grand_total?: number | null
+	base_discount_tax_compensation_amount?: number | null
+	base_shipping_amount?: number | null
+	base_shipping_discount_tax_compensation_amnt?: number | null
+	base_shipping_incl_tax?: number | null
+	base_shipping_tax_amount?: number | null
+	base_subtotal?: number | null
+	base_subtotal_incl_tax?: number | null
+	base_tax_amount?: number | null
+	base_to_global_rate?: number | null
+	base_to_order_rate?: number | null
+	creditmemo_status?: number | null
+	discount_amount?: number | null
+	discount_description?: string | null
+	email_sent?: number | null
+	entity_id?: number | null
+	global_currency_code?: string | null
+	grand_total?: number | null
+	discount_tax_compensation_amount?: number | null
+	increment_id?: string | null
+	invoice_id?: number | null
+	order_currency_code?: string | null
+	shipping_amount?: number | null
+	shipping_discount_tax_compensation_amount?: number | null
+	shipping_incl_tax?: number | null
+	shipping_tax_amount?: number | null
+	state?: number | null
+	store_currency_code?: string | null
+	store_id?: number | null
+	store_to_base_rate?: number | null
+	store_to_order_rate?: number | null
+	subtotal?: number | null
+	subtotal_incl_tax?: number | null
+	tax_amount?: number | null
+	user?: string | null
+}
+
+

package/app/composables/schema/commerce/digitalProducts.ts

@@ -0,0 +1,13 @@
+import { MeeoviProduct } from './product'
+
+export interface MeeoviDigitalProduct {
+	id: string
+	title: string
+	downloadUrl?: string | null
+	fileId?: string | null
+	product?: MeeoviProduct
+	price?: number
+	currency?: string
+	metadata?: Record<string, unknown>
+}
+

package/app/composables/schema/commerce/directory.ts

@@ -0,0 +1,8 @@
+export interface MeeoviDirectoryEntry {
+	id: string
+	name: string
+	type?: string | null
+	url?: string | null
+	metadata?: Record<string, unknown>
+}
+

package/app/composables/schema/commerce/events.ts

@@ -0,0 +1,30 @@
+export interface MeeoviEvent {
+	id: number
+	status?: string | null
+	sort?: number | null
+	user_created?: string | null
+	date_created?: string | null
+	user_updated?: string | null
+	date_updated?: string | null
+	name?: string | null
+	description?: string | null
+	event_calendar?: string | null
+	image?: string | null
+	location?: string | null
+	start_time?: string | null
+	end_time?: string | null
+	url?: string | null
+	postalcode?: string | null
+	type?: string | null
+	qr_code?: string | null
+	check_in?: string | null
+	rsvp_status?: string | null
+	rsvp_policies?: Record<string, unknown> | null
+	date?: string | null
+	slug?: string | null
+	tickets_url?: string | null
+	address?: string | null
+	// relations omitted
+}
+
+

package/app/composables/schema/commerce/gift-registry.ts

@@ -0,0 +1,9 @@
+import { MeeoviProduct } from './product'
+
+export interface MeeoviGiftRegistry {
+	id: string
+	ownerId?: string | null
+	items: MeeoviProduct[]
+	metadata?: Record<string, unknown>
+}
+

package/app/composables/schema/commerce/guest-cart.ts

@@ -0,0 +1,6 @@
+import { MeeoviCart } from './cart'
+
+export interface MeeoviGuestCart extends MeeoviCart {
+	guestId: string
+}
+

package/app/composables/schema/commerce/inventory.ts

@@ -0,0 +1,9 @@
+export interface MeeoviInventoryLot {
+	id: number
+	location_id?: number | null
+	qty?: number | null
+	batch?: string | null
+	expires_at?: string | null
+	created_at?: string | null
+}
+

package/app/composables/schema/commerce/invoices.ts

@@ -0,0 +1,49 @@
+export interface MeeoviInvoice {
+	id: string
+	created_at?: string | null
+	updated_at?: string | null
+	base_currency_code?: string | null
+	base_discount_amount?: number | null
+	base_grand_total?: number | null
+	base_discount_tax_compensation_amount?: number | null
+	base_shipping_amount?: number | null
+	base_shipping_discount_tax_compensation_amnt?: number | null
+	base_shipping_incl_tax?: number | null
+	base_shipping_tax_amount?: number | null
+	base_subtotal?: number | null
+	base_subtotal_incl_tax?: number | null
+	base_tax_amount?: number | null
+	base_total_refunded?: number | null
+	base_to_global_rate?: number | null
+	base_to_order_rate?: number | null
+	can_void_flag?: number | null
+	discount_amount?: number | null
+	discount_description?: string | null
+	email_sent?: number | null
+	entity_id?: number | null
+	global_currency_code?: string | null
+	grand_total?: number | null
+	discount_tax_compensation_amount?: number | null
+	increment_id?: string | null
+	is_used_for_refund?: number | null
+	order_currency_code?: string | null
+	shipping_amount?: number | null
+	shipping_discount_tax_compensation_amount?: number | null
+	shipping_incl_tax?: number | null
+	shipping_tax_amount?: number | null
+	state?: number | null
+	store_currency_code?: string | null
+	store_id?: number | null
+	store_to_base_rate?: number | null
+	store_to_order_rate?: number | null
+	subtotal?: number | null
+	subtotal_incl_tax?: number | null
+	tax_amount?: number | null
+	total_qty?: number | null
+	user?: string | null
+	plan?: string | null
+	service_period?: string | null
+	payment_period?: string | null
+}
+
+

package/app/composables/schema/commerce/orders.ts

@@ -0,0 +1,39 @@
+import { MeeoviProduct } from './product'
+
+export interface MeeoviOrderItem {
+	id: number
+	quantity?: number | null
+	price?: number | null
+}
+
+export interface MeeoviOrder {
+	id: number
+	status?: string | null
+	date_created?: string | null
+	date_updated?: string | null
+	type?: string | null
+	adjustment_negative?: number | null
+	adjustment_positive?: number | null
+	applied_rule_ids?: string | null
+	base_adjustment_negative?: number | null
+	base_adjustment_positive?: number | null
+	base_currency_code?: string | null
+	base_discount_amount?: number | null
+	base_discount_canceled?: number | null
+	base_discount_invoiced?: number | null
+	base_discount_refunded?: number | null
+	base_grand_total?: number | null
+	// many more base_* and other fields omitted for brevity; include as needed
+	coupon_code?: string | null
+	customer_email?: string | null
+	grand_total?: number | null
+	order_currency_code?: string | null
+	shipping_amount?: number | null
+	subtotal?: number | null
+	tax_amount?: number | null
+	payment_status?: string | null
+	user_id?: string | null
+	// relations omitted: incentives_orders[], invoices_orders[], order_items_orders[], etc.
+}
+
+

package/app/composables/schema/commerce/payments.ts

@@ -0,0 +1,11 @@
+export interface MeeoviPayment {
+	id: number
+	status?: string | null
+	description?: string | null
+	gateway?: string | null
+	amount?: number | null
+	created_at?: string | null
+	// relations omitted: payments_countries[], payments_currency[]
+}
+
+

package/app/composables/schema/commerce/price.ts

@@ -0,0 +1,12 @@
+export interface MeeoviCurrency {
+	id: number
+	sort?: number | null
+	date_created?: string | null
+	date_updated?: string | null
+	name?: string | null
+	code?: string | null
+	symbol?: string | null
+	// relations omitted: countries_currency[], currency_departments[], etc.
+}
+
+

package/app/composables/schema/commerce/product-types.ts

@@ -0,0 +1,9 @@
+export interface MeeoviProductType {
+	id: number
+	name?: string | null
+	isShippable?: boolean | null
+	options?: Record<string, unknown> | null
+	// relations omitted: attributes_product_types[], integrations_product_types[], product_types_products[], videos_product_types[]
+}
+
+

package/app/composables/schema/commerce/product.ts

@@ -0,0 +1,23 @@
+export interface MeeoviProduct {
+	id: string
+	sku?: string | null
+	name?: string | null
+	tax_class?: string | null
+	created_at?: string | null
+	content?: string | null
+	part_number?: string | null
+	file?: string | null
+	image?: string | null
+	visibility?: boolean | null
+	stock?: number | null
+	rating?: number | null
+	salable_quantity?: string | null
+	updated_at?: string | null
+	status?: string | null
+	price?: number | null
+	ratings?: string | null
+	uuid?: string | null
+	// relations omitted: many relation arrays like Space_products[], brands_products[], variants[], etc.
+}
+
+

package/app/composables/schema/commerce/quotes.ts

@@ -0,0 +1,10 @@
+export interface MeeoviQuote {
+	id: string
+	customerId?: string | null
+	items: Array<{ productId: string; quantity: number; price: number }>
+	total: number
+	currency: string
+	status?: string | null
+	metadata?: Record<string, unknown>
+}
+