@porulle/core 0.10.0 → 0.10.2

package/dist/interfaces/rest/routes/promotions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promotions.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/rest/routes/promotions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGzD,OAAO,EAAE,KAAK,MAAM,EAAqD,MAAM,aAAa,CAAC;AAG7F,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,gCA4G7C"}
+{"version":3,"file":"promotions.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/rest/routes/promotions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGzD,OAAO,EAAE,KAAK,MAAM,EAAqD,MAAM,aAAa,CAAC;AAG7F,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,gCAiH7C"}

package/dist/interfaces/rest/routes/promotions.js

@@ -46,7 +46,12 @@ export function promotionRoutes(kernel) {
         const payload = c.req.valid("json");
         const actor = c.get("actor");
         const orgId = resolveOrgId(actor);
-        const result = await kernel.services.promotions.validate(payload.code, {
+        // Apply (not just validate) so the response carries the authoritative
+        // discount the cart would receive — the same computation checkout runs.
+        // Returning only the promotion forces callers to re-derive the amount, which
+        // drifts from checkout and shows customers a wrong number. apply() still
+        // Err's on an invalid / inapplicable code (it validates first).
+        const result = await kernel.services.promotions.apply(payload.code, {
             orgId,
             currency: payload.currency,
             subtotal: payload.subtotal,

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

@@ -48,6 +48,24 @@ export declare const ValidatePromotionBodySchema: z.ZodObject<{
 export declare const PromotionResponseSchema: z.ZodObject<{
     data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strip>;
+export declare const PromotionValidationResultSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        totalDiscount: z.ZodNumber;
+        freeShipping: z.ZodBoolean;
+        applied: z.ZodArray<z.ZodObject<{
+            promotionId: z.ZodString;
+            code: z.ZodOptional<z.ZodString>;
+            type: z.ZodString;
+            discountAmount: z.ZodNumber;
+            freeShipping: z.ZodBoolean;
+            description: z.ZodString;
+        }, z.core.$strip>>;
+        rejectedCodes: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export declare const listPromotionsRoute: {
     method: "get";
     path: "/";
@@ -371,7 +389,22 @@ export declare const validatePromotionRoute: {
             content: {
                 "application/json": {
                     schema: z.ZodObject<{
-                        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        data: z.ZodObject<{
+                            totalDiscount: z.ZodNumber;
+                            freeShipping: z.ZodBoolean;
+                            applied: z.ZodArray<z.ZodObject<{
+                                promotionId: z.ZodString;
+                                code: z.ZodOptional<z.ZodString>;
+                                type: z.ZodString;
+                                discountAmount: z.ZodNumber;
+                                freeShipping: z.ZodBoolean;
+                                description: z.ZodString;
+                            }, z.core.$strip>>;
+                            rejectedCodes: z.ZodArray<z.ZodObject<{
+                                code: z.ZodString;
+                                reason: z.ZodString;
+                            }, z.core.$strip>>;
+                        }, z.core.$strip>;
                     }, z.core.$strip>;
                 };
             };

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

@@ -1 +1 @@
-{"version":3,"file":"promotions.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/rest/schemas/promotions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAe,MAAM,mBAAmB,CAAC;AAKnD,OAAO,EACL,yBAAyB,EAE1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,CAAC;AAErC,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAErC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;iBAaF,CAAC;AAIvC,eAAO,MAAM,uBAAuB;;iBAEL,CAAC;AAUhC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiB9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB/B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsB/B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAenC,CAAC"}
+{"version":3,"file":"promotions.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/rest/schemas/promotions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAe,MAAM,mBAAmB,CAAC;AAKnD,OAAO,EACL,yBAAyB,EAE1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,CAAC;AAErC,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAErC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;iBAaF,CAAC;AAIvC,eAAO,MAAM,uBAAuB;;iBAEL,CAAC;AAKhC,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;iBAoBL,CAAC;AAUxC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiB9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoB/B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsB/B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAenC,CAAC"}

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

@@ -22,6 +22,30 @@ export const ValidatePromotionBodySchema = z.object({
 export const PromotionResponseSchema = z.object({
     data: z.record(z.string(), z.unknown()),
 }).openapi("PromotionResponse");
+// The authoritative result of applying a code to a cart — the SAME computation
+// checkout uses, so a storefront can show the exact discount the order will get
+// (no client-side re-derivation, which would drift from checkout).
+export const PromotionValidationResultSchema = z.object({
+    data: z.object({
+        totalDiscount: z.number().openapi({
+            example: 1000,
+            description: "Discount this code applies to the cart, in the cart's minor units (e.g. cents).",
+        }),
+        freeShipping: z.boolean().openapi({ example: false }),
+        applied: z.array(z.object({
+            promotionId: z.string(),
+            code: z.string().optional(),
+            type: z.string(),
+            discountAmount: z.number(),
+            freeShipping: z.boolean(),
+            description: z.string(),
+        })).openapi({ description: "The promotion(s) applied by this code." }),
+        rejectedCodes: z.array(z.object({
+            code: z.string(),
+            reason: z.string(),
+        })),
+    }),
+}).openapi("PromotionValidationResult");
 // ─── Path Params ────────────────────────────────────────────────────────────
 const PromotionIdParam = z.object({
     id: z.uuid().openapi({ example: "550e8400-e29b-41d4-a716-446655440000" }),
@@ -81,8 +105,8 @@ export const validatePromotionRoute = createRoute({
     },
     responses: {
         200: {
-            content: { "application/json": { schema: PromotionResponseSchema } },
-            description: "Promotion validation result.",
+            content: { "application/json": { schema: PromotionValidationResultSchema } },
+            description: "The code is valid for this cart: the authoritative discount it applies (same computation as checkout).",
         },
         ...errorResponses,
     },

package/dist/kernel/database/adapter.d.ts

@@ -10,6 +10,14 @@ export interface DatabaseAdapter<TDatabase = unknown, TTransaction = unknown> {
     provider: string;
     db: TDatabase;
     transaction<T>(fn: (tx: TTransaction) => Promise<T>): Promise<T>;
+    /**
+     * Zero-migration adapters (e.g. PGlite) set this so the runtime pushes any
+     * plugin-declared tables (`config.customSchemas`) at boot. Plugin schemas
+     * only exist after plugins run in `defineConfig` — i.e. after this adapter was
+     * constructed — so the adapter cannot create them itself. Omit/false when the
+     * consumer manages migrations (e.g. production Postgres via drizzle-kit).
+     */
+    autoMigrate?: boolean;
 }
 export interface DatabaseConnectionFactoryInput {
     adapter: DatabaseAdapter;

package/dist/kernel/database/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/kernel/database/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe,CAAC,SAAS,GAAG,OAAO,EAAE,YAAY,GAAG,OAAO;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,eAAe,CAAC;CAC1B;AASD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAMpC;AAsCD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,8BAA8B,GAAG,eAAe,CAS/F"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/kernel/database/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe,CAAC,SAAS,GAAG,OAAO,EAAE,YAAY,GAAG,OAAO;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjE;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,eAAe,CAAC;CAC1B;AASD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAMpC;AAsCD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,8BAA8B,GAAG,eAAe,CAS/F"}

package/dist/kernel/database/migrate.d.ts

@@ -54,5 +54,5 @@ export declare function getSchemaFiles(): string[];
  * Drizzle instance bound to your database. `drizzle-kit` must be available
  * (it is the standard schema tool); a clear error is thrown if it is not.
  */
-export declare function pushSchema(drizzleInstance: unknown): Promise<void>;
+export declare function pushSchema(drizzleInstance: unknown, config?: CommerceConfig): Promise<void>;
 //# sourceMappingURL=migrate.d.ts.map

package/dist/kernel/database/migrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/kernel/database/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC;;;GAGG;AACH,wBAAgB,SAAS,kBAExB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwB5E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CASxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAKzC;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,eAAe,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxE"}
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/kernel/database/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC;;;GAGG;AACH,wBAAgB,SAAS,kBAExB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwB5E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CASxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAKzC;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,eAAe,EAAE,OAAO,EACxB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/kernel/database/migrate.js

@@ -86,7 +86,7 @@ export function getSchemaFiles() {
  * Drizzle instance bound to your database. `drizzle-kit` must be available
  * (it is the standard schema tool); a clear error is thrown if it is not.
  */
-export async function pushSchema(drizzleInstance) {
+export async function pushSchema(drizzleInstance, config) {
     const require = createRequire(import.meta.url);
     let drizzleKit;
     try {
@@ -95,7 +95,10 @@ export async function pushSchema(drizzleInstance) {
     catch {
         throw new Error("pushSchema() requires `drizzle-kit` to be installed. Add it to your project: bun add -d drizzle-kit");
     }
+    // With a config, push the merged core + plugin schema so plugin-declared
+    // tables are created too; without one, push core only (backward compatible).
+    const schemaToApply = config ? buildSchema(config) : getSchema();
     // drizzle-kit needs the native driver result shape; unwrap a normalized db.
-    const { apply } = await drizzleKit.pushSchema(getSchema(), unwrapDb(drizzleInstance));
+    const { apply } = await drizzleKit.pushSchema(schemaToApply, unwrapDb(drizzleInstance));
     await apply();
 }

package/dist/runtime/commerce.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commerce.d.ts","sourceRoot":"","sources":["../../src/runtime/commerce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAkB,KAAK,gBAAgB,EAAwB,MAAM,wBAAwB,CAAC;AAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,GAAG,EAAE,gBAAgB,CAAC;IAEtB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IAEf,mDAAmD;IACnD,EAAE,EAAE,OAAO,CAAC;IAEZ,yDAAyD;IACzD,IAAI,EAAE,YAAY,CAAC;IAEnB,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,gBAAgB,CAAC;IAE1C;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,gBAAgB,CAAC;CACtE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAoC3B"}
+{"version":3,"file":"commerce.d.ts","sourceRoot":"","sources":["../../src/runtime/commerce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAK1C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAkB,KAAK,gBAAgB,EAAwB,MAAM,wBAAwB,CAAC;AAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,GAAG,EAAE,gBAAgB,CAAC;IAEtB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IAEf,mDAAmD;IACnD,EAAE,EAAE,OAAO,CAAC;IAEZ,yDAAyD;IACzD,IAAI,EAAE,YAAY,CAAC;IAEnB,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,gBAAgB,CAAC;IAE1C;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,gBAAgB,CAAC;CACtE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,gBAAgB,CAAC,CA6C3B"}

package/dist/runtime/commerce.js

@@ -1,4 +1,5 @@
 import { createKernel } from "./kernel.js";
+import { pushSchema } from "../kernel/database/migrate.js";
 import { ensureDefaultOrg, setBootDefaultOrgId } from "../auth/org.js";
 import { setBootStrictOrgResolution } from "../auth/strict-org-resolution.js";
 import { createAuth } from "../auth/setup.js";
@@ -17,6 +18,14 @@ import { createLocalAPI } from "../kernel/local-api.js";
  */
 export async function createCommerce(config) {
     const kernel = createKernel(config);
+    // Zero-migration adapters (PGlite) push core schema at construction, but a
+    // plugin's own tables live in `config.customSchemas`, which only exist after
+    // plugins run in `defineConfig` — i.e. after the adapter was constructed.
+    // Create them now so plugin routes have their tables. Guarded on both signals
+    // so plugin-less stores and migration-managed adapters (Postgres) are untouched.
+    if (config.databaseAdapter?.autoMigrate && config.customSchemas?.length) {
+        await pushSchema(kernel.database.db, config);
+    }
     setBootStrictOrgResolution(config.auth?.strictOrgResolution === true);
     // Register the config-driven org ID so resolveOrgId() can use it
     // without requiring every service to have config access.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@porulle/core",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -56,8 +56,8 @@
     "eslint": "^9.39.1",
     "typescript": "5.9.2",
     "vitest": "^3.2.4",
-    "@porulle/typescript-config": "0.1.0",
-    "@porulle/eslint-config": "0.1.0"
+    "@porulle/eslint-config": "0.1.0",
+    "@porulle/typescript-config": "0.1.0"
   },
   "publishConfig": {
     "access": "public"

package/src/interfaces/rest/routes/promotions.ts

@@ -61,7 +61,12 @@ export function promotionRoutes(kernel: Kernel) {
     const actor = c.get("actor");
     const orgId = resolveOrgId(actor);
 
-    const result = await kernel.services.promotions.validate(payload.code, {
+    // Apply (not just validate) so the response carries the authoritative
+    // discount the cart would receive — the same computation checkout runs.
+    // Returning only the promotion forces callers to re-derive the amount, which
+    // drifts from checkout and shows customers a wrong number. apply() still
+    // Err's on an invalid / inapplicable code (it validates first).
+    const result = await kernel.services.promotions.apply(payload.code, {
       orgId,
       currency: payload.currency,
       subtotal: payload.subtotal,

package/src/interfaces/rest/schemas/promotions.ts

@@ -34,6 +34,31 @@ export const PromotionResponseSchema = z.object({
   data: z.record(z.string(), z.unknown()),
 }).openapi("PromotionResponse");
 
+// The authoritative result of applying a code to a cart — the SAME computation
+// checkout uses, so a storefront can show the exact discount the order will get
+// (no client-side re-derivation, which would drift from checkout).
+export const PromotionValidationResultSchema = z.object({
+  data: z.object({
+    totalDiscount: z.number().openapi({
+      example: 1000,
+      description: "Discount this code applies to the cart, in the cart's minor units (e.g. cents).",
+    }),
+    freeShipping: z.boolean().openapi({ example: false }),
+    applied: z.array(z.object({
+      promotionId: z.string(),
+      code: z.string().optional(),
+      type: z.string(),
+      discountAmount: z.number(),
+      freeShipping: z.boolean(),
+      description: z.string(),
+    })).openapi({ description: "The promotion(s) applied by this code." }),
+    rejectedCodes: z.array(z.object({
+      code: z.string(),
+      reason: z.string(),
+    })),
+  }),
+}).openapi("PromotionValidationResult");
+
 // ─── Path Params ────────────────────────────────────────────────────────────
 
 const PromotionIdParam = z.object({
@@ -98,8 +123,8 @@ export const validatePromotionRoute = createRoute({
   },
   responses: {
     200: {
-      content: { "application/json": { schema: PromotionResponseSchema } },
-      description: "Promotion validation result.",
+      content: { "application/json": { schema: PromotionValidationResultSchema } },
+      description: "The code is valid for this cart: the authoritative discount it applies (same computation as checkout).",
     },
     ...errorResponses,
   },

package/src/kernel/database/adapter.ts

@@ -10,6 +10,14 @@ export interface DatabaseAdapter<TDatabase = unknown, TTransaction = unknown> {
   provider: string;
   db: TDatabase;
   transaction<T>(fn: (tx: TTransaction) => Promise<T>): Promise<T>;
+  /**
+   * Zero-migration adapters (e.g. PGlite) set this so the runtime pushes any
+   * plugin-declared tables (`config.customSchemas`) at boot. Plugin schemas
+   * only exist after plugins run in `defineConfig` — i.e. after this adapter was
+   * constructed — so the adapter cannot create them itself. Omit/false when the
+   * consumer manages migrations (e.g. production Postgres via drizzle-kit).
+   */
+  autoMigrate?: boolean;
 }
 
 export interface DatabaseConnectionFactoryInput {

package/src/kernel/database/migrate.ts

@@ -103,7 +103,10 @@ export function getSchemaFiles(): string[] {
  * Drizzle instance bound to your database. `drizzle-kit` must be available
  * (it is the standard schema tool); a clear error is thrown if it is not.
  */
-export async function pushSchema(drizzleInstance: unknown): Promise<void> {
+export async function pushSchema(
+  drizzleInstance: unknown,
+  config?: CommerceConfig,
+): Promise<void> {
   const require = createRequire(import.meta.url);
   let drizzleKit: {
     pushSchema(
@@ -118,7 +121,10 @@ export async function pushSchema(drizzleInstance: unknown): Promise<void> {
       "pushSchema() requires `drizzle-kit` to be installed. Add it to your project: bun add -d drizzle-kit",
     );
   }
+  // With a config, push the merged core + plugin schema so plugin-declared
+  // tables are created too; without one, push core only (backward compatible).
+  const schemaToApply = config ? buildSchema(config) : getSchema();
   // drizzle-kit needs the native driver result shape; unwrap a normalized db.
-  const { apply } = await drizzleKit.pushSchema(getSchema(), unwrapDb(drizzleInstance));
+  const { apply } = await drizzleKit.pushSchema(schemaToApply, unwrapDb(drizzleInstance));
   await apply();
 }

package/src/runtime/commerce.ts

@@ -2,6 +2,7 @@ import type { Actor } from "../auth/types.js";
 import type { CommerceConfig } from "../config/types.js";
 import type { Kernel } from "./kernel.js";
 import { createKernel } from "./kernel.js";
+import { pushSchema } from "../kernel/database/migrate.js";
 import { ensureDefaultOrg, setBootDefaultOrgId } from "../auth/org.js";
 import { setBootStrictOrgResolution } from "../auth/strict-org-resolution.js";
 import { createAuth, type AuthInstance } from "../auth/setup.js";
@@ -122,6 +123,15 @@ export async function createCommerce(
 ): Promise<CommerceInstance> {
   const kernel = createKernel(config);
 
+  // Zero-migration adapters (PGlite) push core schema at construction, but a
+  // plugin's own tables live in `config.customSchemas`, which only exist after
+  // plugins run in `defineConfig` — i.e. after the adapter was constructed.
+  // Create them now so plugin routes have their tables. Guarded on both signals
+  // so plugin-less stores and migration-managed adapters (Postgres) are untouched.
+  if (config.databaseAdapter?.autoMigrate && config.customSchemas?.length) {
+    await pushSchema(kernel.database.db, config);
+  }
+
   setBootStrictOrgResolution(config.auth?.strictOrgResolution === true);
 
   // Register the config-driven org ID so resolveOrgId() can use it