@porulle/core 0.6.0 → 0.8.0

package/dist/modules/pricing/service.js

@@ -42,6 +42,11 @@ function quantityRangeWidth(min, max) {
         return Number.MAX_SAFE_INTEGER - 1;
     return Number.MAX_SAFE_INTEGER;
 }
+function sameNaturalKeyDate(a, b) {
+    if (a == null || b == null)
+        return (a ?? null) === (b ?? null);
+    return a.getTime() === b.getTime();
+}
 function compareBasePriceSpecificity(a, b, context) {
     const aVariant = context.variantId !== undefined && a.variantId === context.variantId
         ? 1
@@ -116,7 +121,20 @@ export class PricingService {
             validFrom: input.validFrom ?? null,
             validUntil: input.validUntil ?? null,
         };
-        const record = await this.repo.createPrice(priceData, ctx);
+        // Upsert on the natural key. "Set base price" is idempotent per
+        // (org, entity, variant, currency, customerGroup, qty range, validity):
+        // a repeat call replaces the existing row's amount instead of appending a
+        // shadow row that the resolver would then tie-break on createdAt.
+        const existing = (await this.repo.findPricesByEntityId(orgId, input.entityId, ctx)).find((p) => p.currency === priceData.currency &&
+            p.variantId === (priceData.variantId ?? null) &&
+            p.customerGroupId === (priceData.customerGroupId ?? null) &&
+            p.minQuantity === (priceData.minQuantity ?? null) &&
+            p.maxQuantity === (priceData.maxQuantity ?? null) &&
+            sameNaturalKeyDate(p.validFrom, priceData.validFrom ?? null) &&
+            sameNaturalKeyDate(p.validUntil, priceData.validUntil ?? null));
+        const record = existing
+            ? (await this.repo.updatePrice(existing.id, { amount: priceData.amount, metadata: priceData.metadata }, ctx)) ?? existing
+            : await this.repo.createPrice(priceData, ctx);
         const afterHooks = this.deps.hooks.resolve("pricing.afterCreate");
         const hctx = hookContext(actor ?? ctx?.actor ?? null, this.deps.services, this.deps.database, ctx?.tx ?? null);
         await runAfterHooks(afterHooks, null, record, "create", hctx);
@@ -160,6 +178,44 @@ export class PricingService {
         await runAfterHooks(afterHooks, null, modifier, "create", hctx);
         return Ok(modifier);
     }
+    async listModifiers(filter, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const rows = await this.repo.findModifiers(orgId, {
+            ...(filter?.entityId !== undefined ? { entityId: filter.entityId } : {}),
+            ...(filter?.currency !== undefined
+                ? { currency: normalizeCurrency(filter.currency) }
+                : {}),
+            ...(filter?.active ? { activeAt: new Date() } : {}),
+        }, ctx);
+        return Ok(rows);
+    }
+    async updateModifier(id, patch, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const existing = await this.repo.findModifierById(orgId, id, ctx);
+        if (!existing) {
+            return Err(new CommerceNotFoundError("Price modifier not found."));
+        }
+        const updated = await this.repo.updateModifier(id, {
+            ...(patch.name !== undefined ? { name: patch.name } : {}),
+            ...(patch.value !== undefined ? { value: patch.value } : {}),
+            ...(patch.priority !== undefined ? { priority: patch.priority } : {}),
+            ...(patch.validFrom !== undefined ? { validFrom: patch.validFrom } : {}),
+            ...(patch.validUntil !== undefined ? { validUntil: patch.validUntil } : {}),
+            ...(patch.minQuantity !== undefined ? { minQuantity: patch.minQuantity } : {}),
+            ...(patch.maxQuantity !== undefined ? { maxQuantity: patch.maxQuantity } : {}),
+            ...(patch.metadata !== undefined ? { metadata: patch.metadata } : {}),
+        }, ctx);
+        return Ok(updated);
+    }
+    async deleteModifier(id, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const existing = await this.repo.findModifierById(orgId, id, ctx);
+        if (!existing) {
+            return Err(new CommerceNotFoundError("Price modifier not found."));
+        }
+        await this.repo.deleteModifier(id, ctx);
+        return Ok({ deleted: true });
+    }
     async listPrices(filter, actor, ctx) {
         const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
         // Get all prices for the entity if specified, or filter after retrieval

package/dist/modules/settings/module.d.ts

@@ -0,0 +1,6 @@
+import { storeSettings } from "./schema.js";
+import { SettingsService } from "./service.js";
+export declare const settingsModule: import("../../kernel/module/define.js").AppModule<{
+    storeSettings: typeof storeSettings;
+}, SettingsService, Record<string, never>>;
+//# sourceMappingURL=module.d.ts.map

package/dist/modules/settings/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/modules/settings/module.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,eAAO,MAAM,cAAc;mBACR,OAAO,aAAa;0CAUrC,CAAC"}

package/dist/modules/settings/module.js

@@ -0,0 +1,11 @@
+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({
+    id: "settings",
+    schema: () => ({ storeSettings }),
+    service: (deps) => new SettingsService({
+        repository: new SettingsRepository(deps.db.db),
+    }),
+});

package/dist/modules/settings/repository/index.d.ts

@@ -0,0 +1,16 @@
+import type { TxContext } from "../../../kernel/database/tx-context.js";
+import type { DrizzleDatabase } from "../../../kernel/database/drizzle-db.js";
+import { storeSettings } from "../schema.js";
+export type StoreSetting = typeof storeSettings.$inferSelect;
+/**
+ * Persistence for org-scoped runtime settings (issue #49).
+ */
+export declare class SettingsRepository {
+    private readonly db;
+    constructor(db: DrizzleDatabase);
+    private getDb;
+    findByGroup(orgId: string, group: string, ctx?: TxContext): Promise<StoreSetting | undefined>;
+    findAll(orgId: string, ctx?: TxContext): Promise<StoreSetting[]>;
+    upsert(orgId: string, group: string, value: Record<string, unknown>, ctx?: TxContext): Promise<StoreSetting>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/settings/repository/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/settings/repository/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AAE7D;;GAEG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,eAAe;IAEhD,OAAO,CAAC,KAAK;IAIP,WAAW,CACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAS9B,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQhE,MAAM,CACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,YAAY,CAAC;CAYzB"}

package/dist/modules/settings/repository/index.js

@@ -0,0 +1,41 @@
+import { and, eq } from "drizzle-orm";
+import { storeSettings } from "../schema.js";
+/**
+ * Persistence for org-scoped runtime settings (issue #49).
+ */
+export class SettingsRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    getDb(ctx) {
+        return ctx?.tx ?? this.db;
+    }
+    async findByGroup(orgId, group, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .select()
+            .from(storeSettings)
+            .where(and(eq(storeSettings.organizationId, orgId), eq(storeSettings.group, group)));
+        return rows[0];
+    }
+    async findAll(orgId, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(storeSettings)
+            .where(eq(storeSettings.organizationId, orgId));
+    }
+    async upsert(orgId, group, value, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .insert(storeSettings)
+            .values({ organizationId: orgId, group, value })
+            .onConflictDoUpdate({
+            target: [storeSettings.organizationId, storeSettings.group],
+            set: { value, updatedAt: new Date() },
+        })
+            .returning();
+        return rows[0];
+    }
+}

package/dist/modules/settings/schema.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Org-scoped runtime settings (issue #49).
+ *
+ * One row per (organization, group). Groups are shallow JSON objects —
+ * `general` (currency, timezone, locale), `branding` (receipt header/footer,
+ * store name, logo), `policies` (free-form policy knobs), plus any custom
+ * group a plugin namespaces for itself. PATCH semantics are shallow merge
+ * with `null` deleting a key.
+ */
+export declare const storeSettings: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "store_settings";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "store_settings";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        organizationId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "organization_id";
+            tableName: "store_settings";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        group: import("drizzle-orm/pg-core").PgColumn<{
+            name: "group";
+            tableName: "store_settings";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        value: import("drizzle-orm/pg-core").PgColumn<{
+            name: "value";
+            tableName: "store_settings";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, unknown>;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, unknown>;
+        }>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "store_settings";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "store_settings";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/modules/settings/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/modules/settings/schema.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYvB,CAAC"}

package/dist/modules/settings/schema.js

@@ -0,0 +1,24 @@
+import { index, jsonb, pgTable, text, timestamp, uniqueIndex, uuid } from "drizzle-orm/pg-core";
+import { organization } from "../../auth/auth-schema.js";
+/**
+ * Org-scoped runtime settings (issue #49).
+ *
+ * One row per (organization, group). Groups are shallow JSON objects —
+ * `general` (currency, timezone, locale), `branding` (receipt header/footer,
+ * store name, logo), `policies` (free-form policy knobs), plus any custom
+ * group a plugin namespaces for itself. PATCH semantics are shallow merge
+ * with `null` deleting a key.
+ */
+export const storeSettings = pgTable("store_settings", {
+    id: uuid("id").defaultRandom().primaryKey(),
+    organizationId: text("organization_id")
+        .notNull()
+        .references(() => organization.id, { onDelete: "cascade" }),
+    group: text("group").notNull(),
+    value: jsonb("value").$type().notNull().default({}),
+    createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull(),
+}, (table) => ({
+    orgGroupUnique: uniqueIndex("store_settings_org_group_unique").on(table.organizationId, table.group),
+    orgIdx: index("idx_store_settings_org").on(table.organizationId),
+}));

package/dist/modules/settings/service.d.ts

@@ -0,0 +1,26 @@
+import type { Actor } from "../../auth/types.js";
+import type { TxContext } from "../../kernel/database/tx-context.js";
+import { type Result } from "../../kernel/result.js";
+import type { SettingsRepository } from "./repository/index.js";
+interface SettingsServiceDeps {
+    repository: SettingsRepository;
+}
+/**
+ * Org-scoped runtime settings (issue #49).
+ *
+ * REST-facing methods resolve the org from the actor; `read()` is the
+ * plugin/hook-facing API — an orgId-keyed lookup with no actor requirement so
+ * policy values can be consumed at request time inside any service or hook.
+ */
+export declare class SettingsService {
+    private repository;
+    constructor(deps: SettingsServiceDeps);
+    /** Runtime read for plugins/hooks. Unset groups read as `{}`. */
+    read(orgId: string, group: string, ctx?: TxContext): Promise<Record<string, unknown>>;
+    getGroup(group: string, actor?: Actor | null, ctx?: TxContext): Promise<Result<Record<string, unknown>>>;
+    getAll(actor?: Actor | null, ctx?: TxContext): Promise<Result<Record<string, Record<string, unknown>>>>;
+    /** Shallow merge: keys in `patch` overwrite, `null` deletes the key. */
+    updateGroup(group: string, patch: Record<string, unknown>, actor?: Actor | null, ctx?: TxContext): Promise<Result<Record<string, unknown>>>;
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/modules/settings/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/settings/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAIhE,UAAU,mBAAmB;IAC3B,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAqB;gBAE3B,IAAI,EAAE,mBAAmB;IAIrC,iEAAiE;IAC3D,IAAI,CACR,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAK7B,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAKrC,MAAM,CACV,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAQ3D,wEAAwE;IAClE,WAAW,CACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAkB5C"}

package/dist/modules/settings/service.js

@@ -0,0 +1,51 @@
+import { resolveOrgId } from "../../auth/org.js";
+import { CommerceValidationError } from "../../kernel/errors.js";
+import { Err, Ok } from "../../kernel/result.js";
+const GROUP_NAME_RE = /^[a-z][a-z0-9_-]*$/;
+/**
+ * Org-scoped runtime settings (issue #49).
+ *
+ * REST-facing methods resolve the org from the actor; `read()` is the
+ * plugin/hook-facing API — an orgId-keyed lookup with no actor requirement so
+ * policy values can be consumed at request time inside any service or hook.
+ */
+export class SettingsService {
+    repository;
+    constructor(deps) {
+        this.repository = deps.repository;
+    }
+    /** Runtime read for plugins/hooks. Unset groups read as `{}`. */
+    async read(orgId, group, ctx) {
+        const row = await this.repository.findByGroup(orgId, group, ctx);
+        return row?.value ?? {};
+    }
+    async getGroup(group, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        return Ok(await this.read(orgId, group, ctx));
+    }
+    async getAll(actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const rows = await this.repository.findAll(orgId, ctx);
+        const all = {};
+        for (const row of rows)
+            all[row.group] = row.value;
+        return Ok(all);
+    }
+    /** Shallow merge: keys in `patch` overwrite, `null` deletes the key. */
+    async updateGroup(group, patch, actor, ctx) {
+        if (!GROUP_NAME_RE.test(group)) {
+            return Err(new CommerceValidationError("Settings group must match [a-z][a-z0-9_-]* (e.g. general, branding, policies)."));
+        }
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const current = await this.read(orgId, group, ctx);
+        const next = { ...current };
+        for (const [key, value] of Object.entries(patch)) {
+            if (value === null)
+                delete next[key];
+            else
+                next[key] = value;
+        }
+        const row = await this.repository.upsert(orgId, group, next, ctx);
+        return Ok(row.value);
+    }
+}

package/dist/modules/shipping/calculator.d.ts

@@ -34,6 +34,11 @@ export interface ShippingCalculationInput {
     address?: ShippingAddress;
     isFreeShipping: boolean;
 }
+/**
+ * Total weight (grams) of the shippable line items — used by both the
+ * code-config strategy and runtime zone rates with weight bands.
+ */
+export declare function computeShippableWeightGrams(config: CommerceConfig, catalogRepo: CatalogRepository, lineItems: ShippingLineItem[], ctx?: TxContext): Promise<number>;
 export declare function calculateShippingCost(config: CommerceConfig, catalogRepo: CatalogRepository, input: ShippingCalculationInput, ctx?: TxContext): Promise<{
     amount: number;
     strategy: string;

package/dist/modules/shipping/calculator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../../src/modules/shipping/calculator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GACxB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEN,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;CACzB;AAiFD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,iBAAiB,EAC9B,KAAK,EAAE,wBAAwB,EAC/B,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA+DpE"}
+{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../../src/modules/shipping/calculator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GACxB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEN,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;CACzB;AAiFD;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,gBAAgB,EAAE,EAC7B,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,iBAAiB,EAC9B,KAAK,EAAE,wBAAwB,EAC/B,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA+DpE"}

package/dist/modules/shipping/calculator.js

@@ -51,6 +51,16 @@ function resolveStrategy(config) {
             : {}),
     };
 }
+/**
+ * Total weight (grams) of the shippable line items — used by both the
+ * code-config strategy and runtime zone rates with weight bands.
+ */
+export async function computeShippableWeightGrams(config, catalogRepo, lineItems, ctx) {
+    const flags = await Promise.all(lineItems.map((lineItem) => isShippableEntity(config, catalogRepo, lineItem.entityId, ctx)));
+    const shippable = lineItems.filter((_, i) => flags[i]);
+    const weights = await Promise.all(shippable.map((lineItem) => resolveWeightGrams(catalogRepo, lineItem.entityId, lineItem.variantId, ctx)));
+    return shippable.reduce((sum, lineItem, i) => sum + (weights[i] ?? 0) * lineItem.quantity, 0);
+}
 export async function calculateShippingCost(config, catalogRepo, input, ctx) {
     if (input.isFreeShipping) {
         return { amount: 0, strategy: "promotion:free_shipping", weightGrams: 0 };

package/dist/modules/shipping/module.d.ts

@@ -1,8 +1,12 @@
 import type { CatalogServiceImpl } from "../catalog/service.js";
+import { shippingZones, shippingRates } from "./schema.js";
 import { ShippingService } from "./service.js";
 type ShippingModuleDeps = {
     catalog: CatalogServiceImpl;
 };
-export declare const shippingModule: import("../../kernel/module/define.js").AppModule<Record<string, never>, ShippingService, ShippingModuleDeps>;
+export declare const shippingModule: import("../../kernel/module/define.js").AppModule<{
+    shippingZones: typeof shippingZones;
+    shippingRates: typeof shippingRates;
+}, ShippingService, ShippingModuleDeps>;
 export {};
 //# sourceMappingURL=module.d.ts.map

package/dist/modules/shipping/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/modules/shipping/module.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,KAAK,kBAAkB,GAAG;IACxB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,cAAc,+GAazB,CAAC"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/modules/shipping/module.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,KAAK,kBAAkB,GAAG;IACxB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,cAAc;mBACR,OAAO,aAAa;mBAAiB,OAAO,aAAa;uCAa1E,CAAC"}

package/dist/modules/shipping/module.js

@@ -1,11 +1,14 @@
 import { defineModule } from "../../kernel/module/index.js";
+import { ShippingConfigRepository } from "./repository/index.js";
+import { shippingZones, shippingRates } from "./schema.js";
 import { ShippingService } from "./service.js";
 export const shippingModule = defineModule({
     id: "shipping",
     dependencies: ["catalog"],
-    schema: () => ({}),
+    schema: () => ({ shippingZones, shippingRates }),
     service: (deps) => new ShippingService({
         config: deps.config,
         catalogRepository: deps.services.catalog.repository,
+        repository: new ShippingConfigRepository(deps.db.db),
     }),
 });

package/dist/modules/shipping/repository/index.d.ts

@@ -1,5 +1,30 @@
 import type { TxContext } from "../../../kernel/database/tx-context.js";
-export interface ShippingRepository {
-    ping(ctx: TxContext): Promise<void>;
+import type { DrizzleDatabase } from "../../../kernel/database/drizzle-db.js";
+import { shippingZones, shippingRates } from "../schema.js";
+export type ShippingZone = typeof shippingZones.$inferSelect;
+export type ShippingZoneInsert = typeof shippingZones.$inferInsert;
+export type ShippingRate = typeof shippingRates.$inferSelect;
+export type ShippingRateInsert = typeof shippingRates.$inferInsert;
+/**
+ * Persistence for runtime shipping zones & rates (issue #45).
+ */
+export declare class ShippingConfigRepository {
+    private readonly db;
+    constructor(db: DrizzleDatabase);
+    private getDb;
+    findZoneById(orgId: string, id: string, ctx?: TxContext): Promise<ShippingZone | undefined>;
+    findZones(orgId: string, ctx?: TxContext): Promise<ShippingZone[]>;
+    findActiveZones(orgId: string, ctx?: TxContext): Promise<ShippingZone[]>;
+    createZone(data: ShippingZoneInsert, ctx?: TxContext): Promise<ShippingZone>;
+    updateZone(id: string, data: Partial<Omit<ShippingZoneInsert, "id" | "organizationId">>, ctx?: TxContext): Promise<ShippingZone | undefined>;
+    deleteZone(id: string, ctx?: TxContext): Promise<boolean>;
+    findRateById(orgId: string, id: string, ctx?: TxContext): Promise<ShippingRate | undefined>;
+    findRates(orgId: string, filter?: {
+        zoneId?: string;
+    }, ctx?: TxContext): Promise<ShippingRate[]>;
+    findActiveRatesByZoneId(zoneId: string, ctx?: TxContext): Promise<ShippingRate[]>;
+    createRate(data: ShippingRateInsert, ctx?: TxContext): Promise<ShippingRate>;
+    updateRate(id: string, data: Partial<Omit<ShippingRateInsert, "id" | "organizationId">>, ctx?: TxContext): Promise<ShippingRate | undefined>;
+    deleteRate(id: string, ctx?: TxContext): Promise<boolean>;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/modules/shipping/repository/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/shipping/repository/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/shipping/repository/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AACnE,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AAEnE;;GAEG;AACH,qBAAa,wBAAwB;IACvB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,eAAe;IAEhD,OAAO,CAAC,KAAK;IAMP,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAS3F,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IASlE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IASxE,UAAU,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IAM5E,UAAU,CACd,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,gBAAgB,CAAC,CAAC,EAChE,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAU9B,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAQzD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAS3F,SAAS,CACb,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAC5B,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,YAAY,EAAE,CAAC;IAWpB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IASjF,UAAU,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IAM5E,UAAU,CACd,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,gBAAgB,CAAC,CAAC,EAChE,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAU9B,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;CAKhE"}

package/dist/modules/shipping/repository/index.js

@@ -1 +1,105 @@
-export {};
+import { eq, and, asc } from "drizzle-orm";
+import { shippingZones, shippingRates } from "../schema.js";
+/**
+ * Persistence for runtime shipping zones & rates (issue #45).
+ */
+export class ShippingConfigRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    getDb(ctx) {
+        return ctx?.tx ?? this.db;
+    }
+    // ── Zones ──────────────────────────────────────────────────────────────
+    async findZoneById(orgId, id, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .select()
+            .from(shippingZones)
+            .where(and(eq(shippingZones.organizationId, orgId), eq(shippingZones.id, id)));
+        return rows[0];
+    }
+    async findZones(orgId, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(shippingZones)
+            .where(eq(shippingZones.organizationId, orgId))
+            .orderBy(asc(shippingZones.priority));
+    }
+    async findActiveZones(orgId, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(shippingZones)
+            .where(and(eq(shippingZones.organizationId, orgId), eq(shippingZones.isActive, true)))
+            .orderBy(asc(shippingZones.priority));
+    }
+    async createZone(data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db.insert(shippingZones).values(data).returning();
+        return rows[0];
+    }
+    async updateZone(id, data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .update(shippingZones)
+            .set({ ...data, updatedAt: new Date() })
+            .where(eq(shippingZones.id, id))
+            .returning();
+        return rows[0];
+    }
+    async deleteZone(id, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db.delete(shippingZones).where(eq(shippingZones.id, id)).returning();
+        return rows.length > 0;
+    }
+    // ── Rates ──────────────────────────────────────────────────────────────
+    async findRateById(orgId, id, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .select()
+            .from(shippingRates)
+            .where(and(eq(shippingRates.organizationId, orgId), eq(shippingRates.id, id)));
+        return rows[0];
+    }
+    async findRates(orgId, filter, ctx) {
+        const db = this.getDb(ctx);
+        const conditions = [eq(shippingRates.organizationId, orgId)];
+        if (filter?.zoneId)
+            conditions.push(eq(shippingRates.zoneId, filter.zoneId));
+        return db
+            .select()
+            .from(shippingRates)
+            .where(and(...conditions))
+            .orderBy(asc(shippingRates.amount));
+    }
+    async findActiveRatesByZoneId(zoneId, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(shippingRates)
+            .where(and(eq(shippingRates.zoneId, zoneId), eq(shippingRates.isActive, true)))
+            .orderBy(asc(shippingRates.amount));
+    }
+    async createRate(data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db.insert(shippingRates).values(data).returning();
+        return rows[0];
+    }
+    async updateRate(id, data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .update(shippingRates)
+            .set({ ...data, updatedAt: new Date() })
+            .where(eq(shippingRates.id, id))
+            .returning();
+        return rows[0];
+    }
+    async deleteRate(id, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db.delete(shippingRates).where(eq(shippingRates.id, id)).returning();
+        return rows.length > 0;
+    }
+}