@porulle/core 0.64.0 → 0.65.0

package/src/modules/fulfillment/module.ts

@@ -1,44 +0,0 @@
-import type { CommerceConfig } from "../../config/types.js";
-import type { DrizzleDatabase } from "../../kernel/database/drizzle-db.js";
-import { defineModule } from "../../kernel/module/index.js";
-import type { InventoryService } from "../inventory/service.js";
-import { OrdersRepository } from "../orders/repository/index.js";
-import { FulfillmentRepository } from "./repository/index.js";
-import {
-  fulfillmentEvents,
-  fulfillmentLineItems,
-  fulfillmentRecords,
-} from "./schema.js";
-import { FulfillmentService } from "./service.js";
-
-type FulfillmentModuleDeps = {
-  inventory: InventoryService;
-};
-
-export const fulfillmentModule = defineModule<
-  {
-    fulfillmentRecords: typeof fulfillmentRecords;
-    fulfillmentLineItems: typeof fulfillmentLineItems;
-    fulfillmentEvents: typeof fulfillmentEvents;
-  },
-  FulfillmentService,
-  FulfillmentModuleDeps
->({
-  id: "fulfillment",
-  dependencies: ["inventory"],
-  schema: () => ({
-    fulfillmentRecords,
-    fulfillmentLineItems,
-    fulfillmentEvents,
-  }),
-  service: (deps) =>
-    new FulfillmentService({
-      repository: new FulfillmentRepository(deps.db.db as DrizzleDatabase),
-      ordersRepository: new OrdersRepository(deps.db.db as DrizzleDatabase),
-      inventoryService: deps.services.inventory,
-      hooks: deps.hooks,
-      config: deps.config as CommerceConfig,
-      services: deps.services,
-      database: deps.db,
-    }),
-});

package/src/modules/inventory/module.ts

@@ -1,37 +0,0 @@
-import type { CommerceConfig } from "../../config/types.js";
-import type { DrizzleDatabase } from "../../kernel/database/drizzle-db.js";
-import { defineModule } from "../../kernel/module/index.js";
-import type { CatalogServiceImpl } from "../catalog/service.js";
-import { InventoryRepository } from "./repository/index.js";
-import { inventoryLevels, inventoryMovements, warehouses } from "./schema.js";
-import { InventoryService } from "./service.js";
-
-type InventoryModuleDeps = {
-  catalog: CatalogServiceImpl;
-};
-
-export const inventoryModule = defineModule<
-  {
-    inventoryLevels: typeof inventoryLevels;
-    inventoryMovements: typeof inventoryMovements;
-    warehouses: typeof warehouses;
-  },
-  InventoryService,
-  InventoryModuleDeps
->({
-  id: "inventory",
-  dependencies: ["catalog"],
-  schema: () => ({
-    inventoryLevels,
-    inventoryMovements,
-    warehouses,
-  }),
-  service: (deps) =>
-    new InventoryService({
-      repository: new InventoryRepository(deps.db.db as DrizzleDatabase),
-      hooks: deps.hooks,
-      config: deps.config as CommerceConfig,
-      services: deps.services,
-      database: deps.db,
-    }),
-});

package/src/modules/media/index.ts

@@ -1 +0,0 @@
-export { mediaModule } from "./module.js";

package/src/modules/media/module.ts

@@ -1,27 +0,0 @@
-import type { CommerceConfig } from "../../config/types.js";
-import type { DrizzleDatabase } from "../../kernel/database/drizzle-db.js";
-import { defineModule } from "../../kernel/module/index.js";
-import { CatalogRepository } from "../catalog/repository/index.js";
-import { MediaRepository } from "./repository/index.js";
-import { MediaService } from "./service.js";
-import { entityMedia, mediaAssets } from "./schema.js";
-
-export const mediaModule = defineModule({
-  id: "media",
-  schema: () => ({ mediaAssets, entityMedia }),
-  service: (deps) => {
-    const db = deps.db.db as DrizzleDatabase;
-    const storage = (deps.config as CommerceConfig).storage;
-    if (storage == null) {
-      throw new Error("Media module requires config.storage");
-    }
-    return new MediaService({
-      repository: new MediaRepository(db),
-      catalogRepository: new CatalogRepository(db),
-      storage,
-      config: deps.config as CommerceConfig,
-      database: deps.db,
-      services: deps.services,
-    });
-  },
-});

package/src/modules/orders/module.ts

@@ -1,67 +0,0 @@
-import type { CommerceConfig } from "../../config/types.js";
-import type { DrizzleDatabase } from "../../kernel/database/drizzle-db.js";
-import { defineModule } from "../../kernel/module/index.js";
-import { extendOrderStateMachine } from "../../kernel/state-machine/machine.js";
-import type { CartService } from "../cart/service.js";
-import type { FulfillmentService } from "../fulfillment/service.js";
-import type { InventoryService } from "../inventory/service.js";
-import type { PaymentsService } from "../payments/service.js";
-import type { PricingService } from "../pricing/service.js";
-import type { PromotionService } from "../promotions/service.js";
-import type { TaxService } from "../tax/service.js";
-import { OrdersRepository } from "./repository/index.js";
-import {
-  orderLineItems,
-  orders,
-  orderStatusHistory,
-} from "./schema.js";
-import { OrderService } from "./service.js";
-
-type OrdersModuleDeps = {
-  cart: CartService;
-  inventory: InventoryService;
-  payments: PaymentsService;
-  pricing: PricingService;
-  promotions: PromotionService;
-  fulfillment: FulfillmentService;
-  tax: TaxService;
-};
-
-export const ordersModule = defineModule<
-  {
-    orders: typeof orders;
-    orderLineItems: typeof orderLineItems;
-    orderStatusHistory: typeof orderStatusHistory;
-  },
-  OrderService,
-  OrdersModuleDeps
->({
-  id: "orders",
-  dependencies: [
-    "cart",
-    "inventory",
-    "payments",
-    "pricing",
-    "promotions",
-    "fulfillment",
-    "tax",
-  ],
-  schema: () => ({ orders, orderLineItems, orderStatusHistory }),
-  service: (deps) => {
-    const config = deps.config as CommerceConfig;
-    return new OrderService({
-      repository: new OrdersRepository(deps.db.db as DrizzleDatabase),
-      hooks: deps.hooks,
-      config,
-      services: deps.services,
-      database: deps.db,
-      ...(config.orders?.customTransitions
-        ? {
-            stateMachine: extendOrderStateMachine(
-              config.orders.customTransitions,
-            ),
-          }
-        : {}),
-    });
-  },
-});

package/src/modules/organization/index.ts

@@ -1 +0,0 @@
-export { organizationModule } from "./module.js";

package/src/modules/organization/module.ts

@@ -1,11 +0,0 @@
-import { member, organization } from "../../auth/auth-schema.js";
-import type { DrizzleDatabase } from "../../kernel/database/drizzle-db.js";
-import { defineModule } from "../../kernel/module/index.js";
-import { OrganizationService } from "./service.js";
-
-export const organizationModule = defineModule({
-  id: "organization",
-  schema: () => ({ organization, member }),
-  service: (deps) =>
-    new OrganizationService(deps.db.db as DrizzleDatabase),
-});

package/src/modules/payments/module.ts

@@ -1,14 +0,0 @@
-import type { CommerceConfig } from "../../config/types.js";
-import { defineModule } from "../../kernel/module/index.js";
-import { PaymentsService } from "./service.js";
-
-export const paymentsModule = defineModule<
-  Record<string, never>,
-  PaymentsService,
-  Record<string, never>
->({
-  id: "payments",
-  schema: () => ({}),
-  service: (deps) =>
-    new PaymentsService((deps.config as CommerceConfig).payments),
-});

package/src/modules/payments/repository/index.ts

@@ -1,5 +0,0 @@
-import type { TxContext } from "../../../kernel/database/tx-context.js";
-
-export interface PaymentsRepository {
-  ping(ctx: TxContext): Promise<void>;
-}

package/src/modules/pricing/index.ts

@@ -1 +0,0 @@
-export { pricingModule } from "./module.js";

package/src/modules/pricing/module.ts

@@ -1,32 +0,0 @@
-import type { CommerceConfig } from "../../config/types.js";
-import type { DrizzleDatabase } from "../../kernel/database/drizzle-db.js";
-import { defineModule } from "../../kernel/module/index.js";
-import type { CatalogRepository } from "../catalog/repository/index.js";
-import { PricingRepository } from "./repository/index.js";
-import { PricingService } from "./service.js";
-import { priceModifiers, prices } from "./schema.js";
-
-type PricingModuleDeps = {
-  catalog: {
-    repository: CatalogRepository;
-  };
-};
-
-export const pricingModule = defineModule<
-  { prices: typeof prices; priceModifiers: typeof priceModifiers },
-  PricingService,
-  PricingModuleDeps
->({
-  id: "pricing",
-  dependencies: ["catalog"],
-  schema: () => ({ prices, priceModifiers }),
-  service: (deps) =>
-    new PricingService({
-      repository: new PricingRepository(deps.db.db as DrizzleDatabase),
-      catalogRepository: deps.services.catalog.repository,
-      hooks: deps.hooks,
-      config: deps.config as CommerceConfig,
-      services: deps.services,
-      database: deps.db,
-    }),
-});

package/src/modules/promotions/module.ts

@@ -1,34 +0,0 @@
-import type { CommerceConfig } from "../../config/types.js";
-import type { DrizzleDatabase } from "../../kernel/database/drizzle-db.js";
-import { defineModule } from "../../kernel/module/index.js";
-import type { CatalogServiceImpl } from "../catalog/service.js";
-import type { OrderService } from "../orders/service.js";
-import { OrdersRepository } from "../orders/repository/index.js";
-import { PromotionsRepository } from "./repository/index.js";
-import { promotionUsages, promotions } from "./schema.js";
-import { PromotionService } from "./service.js";
-
-type PromotionsModuleDeps = {
-  catalog: CatalogServiceImpl;
-  orders: OrderService;
-};
-
-export const promotionsModule = defineModule<
-  { promotions: typeof promotions; promotionUsages: typeof promotionUsages },
-  PromotionService,
-  PromotionsModuleDeps
->({
-  id: "promotions",
-  dependencies: ["catalog", "orders"],
-  schema: () => ({ promotions, promotionUsages }),
-  service: (deps) =>
-    new PromotionService({
-      repository: new PromotionsRepository(deps.db.db as DrizzleDatabase),
-      catalogRepository: deps.services.catalog.repository,
-      ordersRepository: new OrdersRepository(deps.db.db as DrizzleDatabase),
-      hooks: deps.hooks,
-      config: deps.config as CommerceConfig,
-      services: deps.services,
-      database: deps.db,
-    }),
-});

package/src/modules/search/module.ts

@@ -1,32 +0,0 @@
-import type { CommerceConfig } from "../../config/types.js";
-import type { PluginDb } from "../../kernel/database/plugin-types.js";
-import { defineModule } from "../../kernel/module/index.js";
-import type { CatalogServiceImpl } from "../catalog/service.js";
-import { SearchService } from "./service.js";
-
-type SearchModuleDeps = {
-  catalog: CatalogServiceImpl;
-};
-
-export const searchModule = defineModule<Record<string, never>, SearchService, SearchModuleDeps>(
-  {
-    id: "search",
-    dependencies: ["catalog"],
-    schema: () => ({}),
-    service: (deps) => {
-      const config = deps.config as CommerceConfig;
-      const adapter = config.search?.adapter;
-      adapter?.init?.({ db: deps.db.db as PluginDb });
-      return new SearchService({
-        catalogRepository: deps.services.catalog.repository,
-        resolveEntityFieldDefinitions: deps.services.catalog.resolveEntityFieldDefinitions.bind(deps.services.catalog),
-        config,
-        ...(config.entities ? { entities: config.entities } : {}),
-        ...(adapter ? { adapter } : {}),
-        ...(config.search?.defaultFacets
-          ? { defaultFacets: config.search.defaultFacets }
-          : {}),
-      });
-    },
-  },
-);

package/src/modules/search/repository/index.ts

@@ -1,5 +0,0 @@
-import type { TxContext } from "../../../kernel/database/tx-context.js";
-
-export interface SearchRepository {
-  ping(ctx: TxContext): Promise<void>;
-}

package/src/modules/settings/module.ts

@@ -1,20 +0,0 @@
-import type { CommerceConfig } from "../../config/types.js";
-import type { DrizzleDatabase } from "../../kernel/database/drizzle-db.js";
-import { defineModule } from "../../kernel/module/index.js";
-import { SettingsRepository } from "./repository/index.js";
-import { storeSettings } from "./schema.js";
-import { SettingsService } from "./service.js";
-
-export const settingsModule = defineModule<
-  { storeSettings: typeof storeSettings },
-  SettingsService,
-  Record<string, never>
->({
-  id: "settings",
-  schema: () => ({ storeSettings }),
-  service: (deps) =>
-    new SettingsService({
-      repository: new SettingsRepository(deps.db.db as DrizzleDatabase),
-      config: deps.config as CommerceConfig,
-    }),
-});

package/src/modules/shipping/module.ts

@@ -1,27 +0,0 @@
-import type { CommerceConfig } from "../../config/types.js";
-import type { DrizzleDatabase } from "../../kernel/database/drizzle-db.js";
-import { defineModule } from "../../kernel/module/index.js";
-import type { CatalogServiceImpl } from "../catalog/service.js";
-import { ShippingConfigRepository } from "./repository/index.js";
-import { shippingZones, shippingRates } from "./schema.js";
-import { ShippingService } from "./service.js";
-
-type ShippingModuleDeps = {
-  catalog: CatalogServiceImpl;
-};
-
-export const shippingModule = defineModule<
-  { shippingZones: typeof shippingZones; shippingRates: typeof shippingRates },
-  ShippingService,
-  ShippingModuleDeps
->({
-  id: "shipping",
-  dependencies: ["catalog"],
-  schema: () => ({ shippingZones, shippingRates }),
-  service: (deps) =>
-    new ShippingService({
-      config: deps.config as CommerceConfig,
-      catalogRepository: deps.services.catalog.repository,
-      repository: new ShippingConfigRepository(deps.db.db as DrizzleDatabase),
-    }),
-});

package/src/modules/tax/module.ts

@@ -1,21 +0,0 @@
-import type { CommerceConfig } from "../../config/types.js";
-import type { DrizzleDatabase } from "../../kernel/database/drizzle-db.js";
-import { defineModule } from "../../kernel/module/index.js";
-import { TaxRatesRepository } from "./repository/index.js";
-import { taxClasses, taxRates } from "./schema.js";
-import { TaxService } from "./service.js";
-
-export const taxModule = defineModule<
-  { taxRates: typeof taxRates; taxClasses: typeof taxClasses },
-  TaxService,
-  Record<string, never>
->({
-  id: "tax",
-  schema: () => ({ taxRates, taxClasses }),
-  service: (deps) =>
-    new TaxService({
-      adapter: (deps.config as CommerceConfig).tax?.adapter,
-      repository: new TaxRatesRepository(deps.db.db as DrizzleDatabase),
-      config: deps.config as CommerceConfig,
-    }),
-});

package/src/modules/webhooks/index.ts

@@ -1 +0,0 @@
-export { webhooksModule } from "./module.js";

package/src/modules/webhooks/module.ts

@@ -1,24 +0,0 @@
-import type { CommerceConfig } from "../../config/types.js";
-import { defineModule } from "../../kernel/module/index.js";
-import type { DrizzleDatabase } from "../../kernel/database/drizzle-db.js";
-import { WebhooksRepository } from "./repository/index.js";
-import { WebhookService } from "./service.js";
-import {
-  processedWebhookEvents,
-  webhookDeliveries,
-  webhookEndpoints,
-} from "./schema.js";
-
-export const webhooksModule = defineModule({
-  id: "webhooks",
-  schema: () => ({
-    webhookEndpoints,
-    processedWebhookEvents,
-    webhookDeliveries,
-  }),
-  service: (deps) =>
-    new WebhookService({
-      repository: new WebhooksRepository(deps.db.db as DrizzleDatabase),
-      config: deps.config as CommerceConfig,
-    }),
-});

package/src/test-utils/create-repository-test-harness.ts

@@ -1,16 +0,0 @@
-import type { CommerceConfig } from "../config/types.js";
-import { createTestConfig } from "./create-test-config.js";
-import { createKernel } from "../runtime/kernel.js";
-
-export interface RepositoryTestHarness {
-  config: CommerceConfig;
-  kernel: ReturnType<typeof createKernel>;
-}
-
-export async function createRepositoryTestHarness(
-  overrides: Partial<CommerceConfig> = {},
-): Promise<RepositoryTestHarness> {
-  const config = await createTestConfig(overrides);
-  const kernel = createKernel(config);
-  return { config, kernel };
-}

package/src/test-utils/create-test-plugin-context.ts

@@ -1,66 +0,0 @@
-import { HookRegistry } from "../kernel/hooks/registry.js";
-import { createLogger } from "../utils/logger.js";
-import { createTestConfig } from "./create-test-config.js";
-import type { CommerceConfig } from "../config/types.js";
-
-interface PluginContextShape {
-  hooks: HookRegistry;
-  config: CommerceConfig;
-  services: Record<string, unknown>;
-  routes: { add(method: string, path: string, handler: (...args: unknown[]) => unknown): void };
-  analytics: { registerModel(model: unknown): void };
-  database: {
-    registerSchema(schema: Record<string, unknown>): void;
-    query: unknown;
-    transaction<T>(fn: (tx: unknown) => Promise<T>): Promise<T>;
-  };
-  logger: { info(message: string, data?: unknown): void; warn(message: string, data?: unknown): void; error(message: string, data?: unknown): void };
-}
-
-export interface TestPluginContext extends PluginContextShape {
-  registeredRoutes: Array<{ method: string; path: string; handler: (...args: unknown[]) => unknown }>;
-  registeredAnalyticsModels: unknown[];
-  registeredSchemas: Array<Record<string, unknown>>;
-}
-
-export async function createTestPluginContext(options?: {
-  config?: Partial<CommerceConfig>;
-  services?: Record<string, unknown>;
-}): Promise<TestPluginContext> {
-  const hooks = new HookRegistry();
-  const config = await createTestConfig(options?.config ?? {});
-  const services = options?.services ?? {};
-
-  const registeredRoutes: TestPluginContext["registeredRoutes"] = [];
-  const registeredAnalyticsModels: unknown[] = [];
-  const registeredSchemas: Array<Record<string, unknown>> = [];
-
-  return {
-    hooks,
-    config,
-    services,
-    routes: {
-      add(method, path, handler) {
-        registeredRoutes.push({ method: method.toUpperCase(), path, handler });
-      },
-    },
-    analytics: {
-      registerModel(model) {
-        registeredAnalyticsModels.push(model);
-      },
-    },
-    database: {
-      registerSchema(schema) {
-        registeredSchemas.push(schema);
-      },
-      query: {},
-      async transaction<T>(fn: (tx: unknown) => Promise<T>): Promise<T> {
-        return fn({});
-      },
-    },
-    logger: createLogger("test-plugin-context"),
-    registeredRoutes,
-    registeredAnalyticsModels,
-    registeredSchemas,
-  };
-}

package/src/test-utils/typed-hooks.ts

@@ -1,55 +0,0 @@
-import type { PluginHookRegistration } from "../kernel/plugin/manifest.js";
-import type { HookContext, HookOperation } from "../kernel/hooks/types.js";
-
-/**
- * Creates a typed before-hook registration for plugins.
- *
- * Narrows the handler signature from the loose `(...args: unknown[]) => unknown`
- * on PluginHookRegistration to the actual `{ data, operation, context }` shape,
- * providing autocomplete on context.jobs.enqueue(), context.logger.info(), etc.
- *
- * @example
- * ```typescript
- * hooks: () => [
- *   beforeHook<{ customerId: string }>("orders.beforeCreate", async ({ data, context }) => {
- *     context.logger.info("order_creating", { customerId: data.customerId });
- *     return data;
- *   }),
- * ],
- * ```
- */
-export function beforeHook<TData>(
-  key: string,
-  handler: (args: {
-    data: TData;
-    operation: HookOperation;
-    context: HookContext;
-  }) => Promise<TData> | TData,
-): PluginHookRegistration {
-  return { key, handler: handler as PluginHookRegistration["handler"] };
-}
-
-/**
- * Creates a typed after-hook registration for plugins.
- *
- * @example
- * ```typescript
- * import { resolveOrgId } from "@porulle/core";
- * hooks: () => [
- *   afterHook<{ id: string; grandTotal: number }>("orders.afterCreate", async ({ result, context }) => {
- *     await context.jobs.enqueue("loyalty:award-points", { orderId: result.id }, { organizationId: resolveOrgId(context.actor) });
- *   }),
- * ],
- * ```
- */
-export function afterHook<TData>(
-  key: string,
-  handler: (args: {
-    data: TData | null;
-    result: TData;
-    operation: HookOperation;
-    context: HookContext;
-  }) => Promise<void> | void,
-): PluginHookRegistration {
-  return { key, handler: handler as PluginHookRegistration["handler"] };
-}

package/src/types/commerce-types.ts

@@ -1,34 +0,0 @@
-import type { sellableEntities } from "../modules/catalog/schema.js";
-import type { orders } from "../modules/orders/schema.js";
-import type { carts } from "../modules/cart/schema.js";
-import type { customers } from "../modules/customers/schema.js";
-import type { inventoryLevels } from "../modules/inventory/schema.js";
-
-/**
- * Central type map for all commerce entities.
- *
- * Plugins can augment this interface via TypeScript module augmentation:
- *
- * ```typescript
- * declare module "@porulle/core" {
- *   interface CommerceModuleTypes {
- *     LoyaltyPoints: {
- *       id: string;
- *       customerId: string;
- *       points: number;
- *       tier: "bronze" | "silver" | "gold";
- *     };
- *   }
- * }
- * ```
- *
- * This enables plugin types to be referenced without importing
- * internal schema modules.
- */
-export interface CommerceModuleTypes {
-  Product: typeof sellableEntities.$inferSelect;
-  Order: typeof orders.$inferSelect;
-  Cart: typeof carts.$inferSelect;
-  Customer: typeof customers.$inferSelect;
-  InventoryLevel: typeof inventoryLevels.$inferSelect;
-}