@spinekit/promo 0.1.1 → 0.2.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as PromoPermissions, i as PromoModuleDeps, n as PromoActorCtx, r as PromoEngineLike, t as CrudGates } from "./types-D07igQha.mjs";
+import { a as PromoPermissions, i as PromoModuleDeps, n as PromoActorCtx, r as PromoEngineLike, t as CrudGates } from "./types-ElFUq9u4.mjs";
 import { PromoFactoryCtx } from "./resources.mjs";
 //#region src/module.d.ts
 declare function createPromoModule<TEngine extends PromoEngineLike>(deps: PromoModuleDeps<TEngine>): import("@classytic/arc/factory").ArcModule<unknown>;

package/dist/placement/promo-placement.d.mts

@@ -1,5 +1,6 @@
-import { r as PromoEngineLike } from "../types-D07igQha.mjs";
+import { r as PromoEngineLike } from "../types-ElFUq9u4.mjs";
 import { EngineRef } from "@spinekit/kit/engine-slot";
+import { PriceBasis } from "@classytic/primitives/price-basis";
 import { StructuredLogger } from "@classytic/primitives/context";
 //#region src/placement/promo-placement.d.ts
 /** Canonical line item shape for the promo engine. Matches `EvaluateInput.items`. */
@@ -26,7 +27,7 @@ interface ReservePromoInput {
   customerTags?: string[];
   /** Actor performing the placement (user, cashier, or 'system'). */
   actorId: string;
-  /** Branch organization ID (BA org) — carried for audit only; promos are company-wide. */
+  /** Tenant organization when promo resources are tenant-scoped. */
   organizationId?: string;
   /**
    * Logger for structured error + audit reporting.
@@ -83,6 +84,7 @@ declare function buildPromoLines(resolvedLines: Array<{
   snapshot: {
     productId?: string;
     unitPrice?: number;
+    priceBasis?: PriceBasis;
   } | undefined;
 }>): PromoLineItem[];
 /** Subtotal from canonical lines — always drives the engine input. */

package/dist/placement/promo-placement.mjs

@@ -1,4 +1,5 @@
 import { resolveEngineRef } from "@spinekit/kit/engine-slot";
+import { resolvePriceBasisTotal } from "@classytic/primitives/price-basis";
 //#region src/placement/promo-placement.ts
 const LOG_PREFIX = "[promo-placement]";
 const SYSTEM_ACTOR_ID = "system";
@@ -6,26 +7,24 @@ const resolveActorId = (actorId) => actorId && actorId.trim().length > 0 ? actor
 /**
 * Build the promo engine context.
 *
-* Promos are company-wide (see `promo.resources.ts` and the `tenant: false`
-* engine boot). Passing `organizationId` would make the repos inject a
-* per-branch filter on reads — programs seeded at company level would
-* become invisible to branch-scoped calls.
-*
-* The `organizationId` arriving into these helpers is carried only for
-* audit logging (which branch triggered the commit), never forwarded to
-* the engine itself.
+* The organization scope is forwarded for shared-SaaS deployments and omitted
+* by single-company hosts whose promo engine is global.
 */
-const buildCtx = (input) => ({ actorRef: input.actorId });
+const buildCtx = (input) => ({
+	actorRef: input.actorId,
+	...input.organizationId !== void 0 ? { organizationId: input.organizationId } : {}
+});
 /** Canonical line builder for placement pipelines — see `placement.service.ts`. */
 function buildPromoLines(resolvedLines) {
 	return resolvedLines.map((line) => {
 		const unitPrice = line.snapshot?.unitPrice ?? 0;
+		const priceBasis = line.snapshot?.priceBasis;
 		return {
 			productId: line.snapshot?.productId ?? line.skuRef,
 			sku: line.skuRef,
 			quantity: line.quantity,
 			unitPrice,
-			lineTotal: unitPrice * line.quantity
+			lineTotal: priceBasis ? resolvePriceBasisTotal(unitPrice, line.quantity, priceBasis) : unitPrice * line.quantity
 		};
 	});
 }
@@ -52,7 +51,10 @@ async function reservePromo(input) {
 		rejectedCodes: []
 	};
 	const actorId = resolveActorId(input.actorId);
-	const ctx = buildCtx({ actorId });
+	const ctx = buildCtx({
+		actorId,
+		...input.organizationId !== void 0 ? { organizationId: input.organizationId } : {}
+	});
 	try {
 		const result = await (await resolveEngineRef(input.engine)).services.evaluation.evaluate({
 			items: input.lines,
@@ -101,7 +103,10 @@ async function commitPromo(reservation, orderId, input) {
 		rejectedCodes: reservation.rejectedCodes
 	};
 	const actorId = resolveActorId(input.actorId);
-	const ctx = buildCtx({ actorId });
+	const ctx = buildCtx({
+		actorId,
+		...input.organizationId !== void 0 ? { organizationId: input.organizationId } : {}
+	});
 	const evaluationId = reservation.evaluationId;
 	try {
 		await (await resolveEngineRef(input.engine)).services.evaluation.commit(evaluationId, orderId, ctx);
@@ -152,7 +157,10 @@ async function commitPromo(reservation, orderId, input) {
 async function rollbackPromo(reservation, input) {
 	if (!reservation.evaluationId) return;
 	const actorId = resolveActorId(input.actorId);
-	const ctx = buildCtx({ actorId });
+	const ctx = buildCtx({
+		actorId,
+		...input.organizationId !== void 0 ? { organizationId: input.organizationId } : {}
+	});
 	try {
 		await (await resolveEngineRef(input.engine)).services.evaluation.rollback(reservation.evaluationId, ctx);
 		input.logger?.info?.({

package/dist/placement/promo.port.d.mts

@@ -1,4 +1,4 @@
-import { r as PromoEngineLike } from "../types-D07igQha.mjs";
+import { r as PromoEngineLike } from "../types-ElFUq9u4.mjs";
 import { PromoPort } from "@classytic/promo";
 import { EngineRef } from "@spinekit/kit/engine-slot";
 //#region src/placement/promo.port.d.ts

package/dist/resources.d.mts

@@ -1,4 +1,4 @@
-import { i as PromoModuleDeps, n as PromoActorCtx, r as PromoEngineLike } from "./types-D07igQha.mjs";
+import { i as PromoModuleDeps, n as PromoActorCtx, r as PromoEngineLike } from "./types-ElFUq9u4.mjs";
 import { PromoModels, PromoRepositories, PromoServices } from "@classytic/promo";
 import { z } from "zod";
 import { FastifyRequest } from "fastify";
@@ -12,10 +12,10 @@ interface PromoFactoryCtx {
   actor: (req: FastifyRequest) => PromoActorCtx;
 }
 declare function buildFactoryCtx(deps: PromoModuleDeps, engine: PromoEngineLike): PromoFactoryCtx;
-declare function createProgramResource(fx: PromoFactoryCtx): import("@classytic/arc").ResourceDefinition<unknown>;
-declare function createVoucherResource(fx: PromoFactoryCtx): import("@classytic/arc").ResourceDefinition<unknown>;
-declare function createRuleResource(fx: PromoFactoryCtx): import("@classytic/arc").ResourceDefinition<unknown>;
-declare function createRewardResource(fx: PromoFactoryCtx): import("@classytic/arc").ResourceDefinition<unknown>;
+declare function createProgramResource(fx: PromoFactoryCtx): import("@classytic/arc").ResourceDefinition<import("@classytic/promo").Program>;
+declare function createVoucherResource(fx: PromoFactoryCtx): import("@classytic/arc").ResourceDefinition<import("@classytic/promo").Voucher>;
+declare function createRuleResource(fx: PromoFactoryCtx): import("@classytic/arc").ResourceDefinition<import("@classytic/promo").Reward>;
+declare function createRewardResource(fx: PromoFactoryCtx): import("@classytic/arc").ResourceDefinition<import("@classytic/promo").Reward>;
 declare function createEvaluationResource(fx: PromoFactoryCtx): import("@classytic/arc").ResourceDefinition<unknown> & {
   readonly actions: {
     commit: {

package/dist/resources.mjs

@@ -1,7 +1,7 @@
 import { promoAction, promoRoute } from "./errors.mjs";
 import { ArcError } from "@classytic/arc/utils";
 import { defineResource, mergeResourceConfig } from "@classytic/arc";
-import { getUserId } from "@classytic/arc/scope";
+import { scopeFirstCtx } from "@classytic/arc/scope";
 import { QueryParser } from "@classytic/mongokit";
 import { createMongooseAdapter } from "@classytic/mongokit/adapter";
 import { z } from "zod";
@@ -14,7 +14,11 @@ import { z } from "zod";
 * model) — id-scoped commit/rollback actions + preview/evaluate routes.
 */
 function defaultActor(req) {
-	return { actorRef: getUserId(req.scope) ?? "anonymous" };
+	const scope = scopeFirstCtx(req);
+	return {
+		actorRef: scope.actorId ?? "anonymous",
+		...scope.organizationId ? { organizationId: scope.organizationId } : {}
+	};
 }
 function buildFactoryCtx(deps, engine) {
 	return {
@@ -36,7 +40,7 @@ function createProgramResource(fx) {
 		displayName: "Promo Programs",
 		tag: "Promotions",
 		prefix: deps.prefixes?.program ?? "/promotions/programs",
-		tenantField: false,
+		tenantField: deps.tenantField ?? false,
 		adapter: createMongooseAdapter(engineModels.Program, engineRepos.program),
 		permissions: {
 			list: gates.list,
@@ -67,9 +71,12 @@ function createProgramResource(fx) {
 			rawHandler: promoRoute(async (req) => {
 				const { id } = req.params;
 				const [program, rules, rewards] = await Promise.all([
-					programRepo.getById(id, { lean: true }),
-					ruleRepo.findAll({ programId: id }),
-					rewardRepo.findAll({ programId: id })
+					programRepo.getById(id, {
+						lean: true,
+						...actor(req)
+					}),
+					ruleRepo.findAll({ programId: id }, actor(req)),
+					rewardRepo.findAll({ programId: id }, actor(req))
 				]);
 				if (!program) throw new ArcError("Program not found", {
 					code: "PROGRAM_NOT_FOUND",
@@ -94,7 +101,7 @@ function createVoucherResource(fx) {
 		displayName: "Promo Vouchers",
 		tag: "Promotions",
 		prefix: deps.prefixes?.voucher ?? "/promotions/vouchers",
-		tenantField: false,
+		tenantField: deps.tenantField ?? false,
 		adapter: createMongooseAdapter(engineModels.Voucher, engineRepos.voucher),
 		/**
 		* A voucher is STORED VALUE, and it is minted only by `/generate` and
@@ -160,7 +167,7 @@ function createVoucherResource(fx) {
 				permissions: gates.get,
 				rawHandler: promoRoute(async (req) => {
 					const { code } = req.params;
-					const data = await voucherRepo.getByCode?.(code);
+					const data = await voucherRepo.getByCode?.(code, actor(req));
 					if (!data) throw new ArcError("Voucher not found", {
 						code: "VOUCHER_NOT_FOUND",
 						statusCode: 404
@@ -171,14 +178,25 @@ function createVoucherResource(fx) {
 		]
 	}));
 }
+/**
+* `cfg` is a discriminated union on `modelKey`, not two independent
+* `'Rule' | 'Reward'` / `'rule' | 'reward'` fields — those let TS pick
+* `modelKey: 'Reward'` alongside `repoKey`'s WHOLE union (nothing ties the two
+* together), and `createMongooseAdapter` then sees a repository argument
+* typed `RuleRepository | RewardRepository` that no single
+* `AdapterRepositoryInput<TDoc>` can satisfy. Branching on `cfg.modelKey`
+* narrows the discriminated union so each branch's `repoKey` is a single
+* literal, matching the model it is actually paired with.
+*/
 function crudResource(fx, cfg) {
+	const adapter = cfg.modelKey === "Rule" ? createMongooseAdapter(fx.engineModels.Rule, fx.engineRepos.rule) : createMongooseAdapter(fx.engineModels.Reward, fx.engineRepos.reward);
 	return defineResource(mergeResourceConfig({
 		name: cfg.name,
 		displayName: cfg.displayName,
 		tag: "Promotions",
 		prefix: cfg.prefix,
-		tenantField: false,
-		adapter: createMongooseAdapter(fx.engineModels[cfg.modelKey], fx.engineRepos[cfg.repoKey]),
+		tenantField: fx.deps.tenantField ?? false,
+		adapter,
 		queryParser: new QueryParser({
 			maxLimit: 100,
 			allowedFilterFields: ["programId", "code"],

package/dist/{types-D07igQha.d.mts → types-ElFUq9u4.d.mts}

@@ -69,6 +69,7 @@ interface PromoPermissions {
 /** Actor context for promo service calls (kernel `actorRef` convention). */
 interface PromoActorCtx {
   actorRef: string;
+  organizationId?: string;
 }
 interface PromoModuleDeps<TEngine extends PromoEngineLike = PromoEngineLike> {
   /**
@@ -115,6 +116,8 @@ interface PromoModuleDeps<TEngine extends PromoEngineLike = PromoEngineLike> {
    */
   onClose?: (fastify: unknown) => void | Promise<void>;
   permissions: PromoPermissions;
+  /** Arc resource tenancy. `false` preserves the company-wide default. */
+  tenantField?: string | false;
   /**
    * Derive the kernel actor context from the request. Default: arc's
    * scope-first actor (`request.scope` userId/clientId) falling back to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spinekit/promo",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Arc module for @classytic/promo — programs, vouchers, rules, rewards, and cart evaluation as composable arc resources. BYO engine; company-wide by default (tenantField: false — a voucher generated at one branch redeems at any other); ships the promo-kernel↔wire error contract (stable UPPER_SNAKE codes + HTTP statuses).",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -55,34 +55,35 @@
     "coupon",
     "evaluation"
   ],
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
   "peerDependencies": {
-    "@classytic/arc": ">=2.34.0",
-    "@classytic/mongokit": ">=3.34.0",
-    "@classytic/primitives": ">=0.23.0",
-    "@classytic/promo": ">=0.7.0",
-    "@spinekit/kit": ">=0.1.0",
-    "mongoose": ">=9.4.1",
-    "zod": ">=4.0.0"
+    "@classytic/arc": ">=2.38.0",
+    "@classytic/mongokit": ">=3.36.0",
+    "@classytic/primitives": ">=0.26.4",
+    "@classytic/promo": ">=0.7.1",
+    "@spinekit/kit": ">=0.4.0",
+    "mongoose": ">=9.9.4",
+    "zod": ">=4.5.4"
   },
   "devDependencies": {
-    "@classytic/arc": "^2.34.0",
+    "@classytic/arc": "^2.38.0",
     "@classytic/arc-testkit": "^0.4.0",
-    "@classytic/mongokit": ">=3.34.0",
-    "@classytic/primitives": ">=0.23.0",
-    "@classytic/promo": ">=0.7.0",
+    "@classytic/mongokit": "^3.36.0",
+    "@classytic/primitives": ">=0.26.4",
+    "@classytic/promo": ">=0.7.1",
+    "@spinekit/kit": "workspace:*",
     "@types/node": "^24.3.0",
     "fastify": "^5.12.0",
-    "mongoose": "^9.7.2",
+    "mongoose": "^9.9.4",
     "tsdown": "^0.22.14",
     "typescript": "^7.0.2",
     "vitest": "^3.2.4",
-    "zod": "^4.3.6",
-    "@spinekit/kit": "0.1.0"
-  },
-  "scripts": {
-    "build": "tsdown",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
+    "zod": "^4.5.4"
   }
-}
+}