@unifiedcommerce/core 0.4.4 → 0.4.5

package/dist/test-utils/test-actors.d.ts

@@ -0,0 +1,15 @@
+import type { Actor } from "../auth/types.js";
+/** Admin with wildcard permissions. Use for setup operations in beforeAll. */
+export declare const testAdminActor: Actor;
+/** Staff with common operational permissions. */
+export declare const testStaffActor: Actor;
+/** Customer with minimal read/write-own permissions. */
+export declare const testCustomerActor: Actor;
+/** Actor with zero permissions. Use for negative auth/perm tests. */
+export declare const testNoPermActor: Actor;
+/**
+ * Builds request headers with optional test actor injection.
+ * The x-test-actor header is parsed by createPluginTestApp's middleware.
+ */
+export declare function jsonHeaders(actor?: Actor): Record<string, string>;
+//# sourceMappingURL=test-actors.d.ts.map

package/dist/test-utils/test-actors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-actors.d.ts","sourceRoot":"","sources":["../../src/test-utils/test-actors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,8EAA8E;AAC9E,eAAO,MAAM,cAAc,EAAE,KAS5B,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,cAAc,EAAE,KAY5B,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,EAAE,KAS/B,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,eAAe,EAAE,KAS7B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIjE"}

package/dist/test-utils/test-actors.js

@@ -0,0 +1,57 @@
+/** Admin with wildcard permissions. Use for setup operations in beforeAll. */
+export const testAdminActor = {
+    type: "user",
+    userId: "test-admin-1",
+    email: "admin@test.local",
+    name: "Test Admin",
+    vendorId: null,
+    organizationId: "org_default",
+    role: "admin",
+    permissions: ["*:*"],
+};
+/** Staff with common operational permissions. */
+export const testStaffActor = {
+    type: "user",
+    userId: "test-staff-1",
+    email: "staff@test.local",
+    name: "Test Staff",
+    vendorId: null,
+    organizationId: "org_default",
+    role: "staff",
+    permissions: [
+        "catalog:read", "catalog:create", "catalog:update",
+        "inventory:adjust", "orders:read", "orders:create", "orders:update",
+    ],
+};
+/** Customer with minimal read/write-own permissions. */
+export const testCustomerActor = {
+    type: "user",
+    userId: "test-customer-1",
+    email: "customer@test.local",
+    name: "Test Customer",
+    vendorId: null,
+    organizationId: "org_default",
+    role: "customer",
+    permissions: ["catalog:read", "cart:create", "cart:read", "orders:read:own"],
+};
+/** Actor with zero permissions. Use for negative auth/perm tests. */
+export const testNoPermActor = {
+    type: "user",
+    userId: "test-noperm-1",
+    email: "noperm@test.local",
+    name: "No Permissions",
+    vendorId: null,
+    organizationId: "org_default",
+    role: "customer",
+    permissions: [],
+};
+/**
+ * Builds request headers with optional test actor injection.
+ * The x-test-actor header is parsed by createPluginTestApp's middleware.
+ */
+export function jsonHeaders(actor) {
+    const headers = { "Content-Type": "application/json" };
+    if (actor)
+        headers["x-test-actor"] = JSON.stringify(actor);
+    return headers;
+}

package/dist/test-utils/typed-hooks.d.ts

@@ -0,0 +1,43 @@
+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 declare function beforeHook<TData>(key: string, handler: (args: {
+    data: TData;
+    operation: HookOperation;
+    context: HookContext;
+}) => Promise<TData> | TData): PluginHookRegistration;
+/**
+ * Creates a typed after-hook registration for plugins.
+ *
+ * @example
+ * ```typescript
+ * hooks: () => [
+ *   afterHook<{ id: string; grandTotal: number }>("orders.afterCreate", async ({ result, context }) => {
+ *     await context.jobs.enqueue("loyalty:award-points", { orderId: result.id });
+ *   }),
+ * ],
+ * ```
+ */
+export declare function afterHook<TData>(key: string, handler: (args: {
+    data: TData | null;
+    result: TData;
+    operation: HookOperation;
+    context: HookContext;
+}) => Promise<void> | void): PluginHookRegistration;
+//# sourceMappingURL=typed-hooks.d.ts.map

package/dist/test-utils/typed-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-hooks.d.ts","sourceRoot":"","sources":["../../src/test-utils/typed-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,IAAI,EAAE;IACd,IAAI,EAAE,KAAK,CAAC;IACZ,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,GAC3B,sBAAsB,CAExB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,IAAI,EAAE;IACd,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;IACd,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACzB,sBAAsB,CAExB"}

package/dist/test-utils/typed-hooks.js

@@ -0,0 +1,35 @@
+/**
+ * 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(key, handler) {
+    return { key, handler: handler };
+}
+/**
+ * Creates a typed after-hook registration for plugins.
+ *
+ * @example
+ * ```typescript
+ * hooks: () => [
+ *   afterHook<{ id: string; grandTotal: number }>("orders.afterCreate", async ({ result, context }) => {
+ *     await context.jobs.enqueue("loyalty:award-points", { orderId: result.id });
+ *   }),
+ * ],
+ * ```
+ */
+export function afterHook(key, handler) {
+    return { key, handler: handler };
+}

package/dist/testing.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Test utilities for UnifiedCommerce plugins and apps.
+ *
+ * Import from "@unifiedcommerce/core/testing" — NOT from "@unifiedcommerce/core".
+ * This sub-path is isolated from the main barrel to avoid pulling drizzle-kit,
+ * tsx, esbuild, and other heavy dev-only deps into bundlers like Turbopack.
+ */
+export { createTestKernel } from "./test-utils/create-test-kernel.js";
+export { createTestPluginContext } from "./test-utils/create-test-plugin-context.js";
+export { createRepositoryTestHarness } from "./test-utils/create-repository-test-harness.js";
+export { createPluginTestApp, type PluginTestApp, type TestAppEnv } from "./test-utils/create-plugin-test-app.js";
+export { testAdminActor, testStaffActor, testCustomerActor, testNoPermActor, jsonHeaders, } from "./test-utils/test-actors.js";
+export { beforeHook, afterHook } from "./test-utils/typed-hooks.js";
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAClH,OAAO,EACL,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAClE,WAAW,GACZ,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/testing.js

@@ -0,0 +1,13 @@
+/**
+ * Test utilities for UnifiedCommerce plugins and apps.
+ *
+ * Import from "@unifiedcommerce/core/testing" — NOT from "@unifiedcommerce/core".
+ * This sub-path is isolated from the main barrel to avoid pulling drizzle-kit,
+ * tsx, esbuild, and other heavy dev-only deps into bundlers like Turbopack.
+ */
+export { createTestKernel } from "./test-utils/create-test-kernel.js";
+export { createTestPluginContext } from "./test-utils/create-test-plugin-context.js";
+export { createRepositoryTestHarness } from "./test-utils/create-repository-test-harness.js";
+export { createPluginTestApp } from "./test-utils/create-plugin-test-app.js";
+export { testAdminActor, testStaffActor, testCustomerActor, testNoPermActor, jsonHeaders, } from "./test-utils/test-actors.js";
+export { beforeHook, afterHook } from "./test-utils/typed-hooks.js";

package/dist/types/commerce-types.d.ts

@@ -0,0 +1,34 @@
+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 "@unifiedcommerce/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;
+}
+//# sourceMappingURL=commerce-types.d.ts.map

package/dist/types/commerce-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce-types.d.ts","sourceRoot":"","sources":["../../src/types/commerce-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,gBAAgB,CAAC,YAAY,CAAC;IAC9C,KAAK,EAAE,OAAO,MAAM,CAAC,YAAY,CAAC;IAClC,IAAI,EAAE,OAAO,KAAK,CAAC,YAAY,CAAC;IAChC,QAAQ,EAAE,OAAO,SAAS,CAAC,YAAY,CAAC;IACxC,cAAc,EAAE,OAAO,eAAe,CAAC,YAAY,CAAC;CACrD"}

package/dist/types/commerce-types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/id.d.ts

@@ -0,0 +1,2 @@
+export declare function makeId(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}

package/dist/utils/id.js

@@ -0,0 +1,3 @@
+export function makeId() {
+    return crypto.randomUUID();
+}

package/dist/utils/logger.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from "../kernel/hooks/types.js";
+export declare function createLogger(scope: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAelD"}

package/dist/utils/logger.js

@@ -0,0 +1,16 @@
+export function createLogger(scope) {
+    return {
+        info(message, data) {
+            // eslint-disable-next-line no-console
+            console.info(`[${scope}] ${message}`, data ?? "");
+        },
+        warn(message, data) {
+            // eslint-disable-next-line no-console
+            console.warn(`[${scope}] ${message}`, data ?? "");
+        },
+        error(message, data) {
+            // eslint-disable-next-line no-console
+            console.error(`[${scope}] ${message}`, data ?? "");
+        },
+    };
+}

package/dist/utils/pagination.d.ts

@@ -0,0 +1,11 @@
+export interface Pagination {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+}
+export declare function paginate<T>(items: T[], page: number, limit: number): {
+    items: T[];
+    pagination: Pagination;
+};
+//# sourceMappingURL=pagination.d.ts.map

package/dist/utils/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAc3G"}

package/dist/utils/pagination.js

@@ -0,0 +1,15 @@
+export function paginate(items, page, limit) {
+    const safeLimit = Math.max(1, limit);
+    const safePage = Math.max(1, page);
+    const start = (safePage - 1) * safeLimit;
+    const sliced = items.slice(start, start + safeLimit);
+    return {
+        items: sliced,
+        pagination: {
+            page: safePage,
+            limit: safeLimit,
+            total: items.length,
+            totalPages: Math.max(1, Math.ceil(items.length / safeLimit)),
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unifiedcommerce/core",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "type": "module",
   "exports": {
     ".": {