@odla-ai/chapter 0.33.1 → 0.34.0

package/README.md

@@ -445,6 +445,11 @@ join-config, application tier validation, and checkout already read. Public
 application contract, and theme. Applicant requests therefore use local
 last-known-good state and never depend on the hub being reachable.
 
+Materialization addresses provisioned groups and tiers by their unique public
+`id` attributes, not by assuming those values are odla-db entity ids. A failed
+materialization returns a bounded JSON `materialization_failed` rejection and
+the transaction leaves the prior active revision unchanged.
+
 The first delivery is empty-history safe: Chapter checks a bounded aggregate
 count before asking odla-db to order revision history. A freshly provisioned
 follower therefore acknowledges revision 1 immediately instead of depending on

package/dist/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  CHAPTER_PROMOTION_ADAPTER: () => CHAPTER_PROMOTION_ADAPTER,
   DEFAULT_CHAPTER_COPY: () => DEFAULT_CHAPTER_COPY,
   DEFAULT_SHARE_FIELDS: () => DEFAULT_SHARE_FIELDS,
   MEMBERSHIP_PAGE_RENDERER: () => MEMBERSHIP_PAGE_RENDERER,
@@ -61,6 +62,7 @@ __export(index_exports, {
   defineChapter: () => defineChapter,
   emailGroupFrom: () => emailGroupFrom,
   endForSlot: () => endForSlot,
+  exportChapterPromotion: () => exportChapterPromotion,
   findApplicationRef: () => findApplicationRef,
   findTier: () => findTier,
   firstPaymentPatch: () => firstPaymentPatch,
@@ -3200,4 +3202,95 @@ function membershipTierPresentationFromMarkdown(presentation, source) {
   if (!result.ok) throw new TypeError(`Invalid membership Markdown: ${result.errors.join("; ")}`);
   return result.value;
 }
+
+// src/promotion.ts
+var import_promotion = require("@odla-ai/promotion");
+var CHAPTER_PROMOTION_ADAPTER = "@odla-ai/chapter/v1";
+var exclusions = (chapterId, paidTierIds) => [
+  {
+    kind: "chapter.providers",
+    id: chapterId,
+    reason: "provider_identity",
+    paths: [
+      ...paidTierIds.map((id2) => `tiers[${id2}].stripePriceId`),
+      "groups.stripePublishableKey",
+      "applications.stripeCustomerId",
+      "applications.stripeSubscriptionId",
+      "meetings.googleEventId"
+    ],
+    detail: "Stripe, Clerk, and Google identities are resolved independently in each target environment."
+  },
+  {
+    kind: "chapter.runtime",
+    id: chapterId,
+    reason: "runtime_state",
+    paths: ["applications.*", "meetings.*", "emailLog.*", "crm_*.*"],
+    detail: "Applicants, meetings, messages, and CRM rows are operational state, not managed signup content."
+  },
+  {
+    kind: "chapter.access",
+    id: chapterId,
+    reason: "personal_data",
+    paths: ["admins.*", "superAdmins.*", "networkNotes.*"],
+    detail: "People, access lists, and private network notes remain local to the target environment."
+  },
+  {
+    kind: "chapter.history",
+    id: chapterId,
+    reason: "authority_history",
+    paths: ["signupControls[active=false]", "signupControls.*At", "signupControls.environment"],
+    detail: "The source retains immutable delivery history; only selected published content is exported."
+  }
+];
+async function exportChapterPromotion(input) {
+  if (!/^sha256:[0-9a-f]{64}$/.test(input.digest)) throw new TypeError("chapter promotion digest is invalid");
+  const checked = validateSignupControlDocument(input.document);
+  if (!checked.ok) throw new TypeError(checked.errors.join("; "));
+  const document = checked.value;
+  if (await signupControlDigest(document) !== input.digest) throw new TypeError("chapter promotion digest does not match its document");
+  const revision = `chapter:${document.target.chapterId}:${document.revision}`;
+  const promotionProvenance = {
+    adapter: CHAPTER_PROMOTION_ADAPTER,
+    sourceIds: [`signup-control:${document.revision}`, document.source.appId, document.target.chapterId].sort(),
+    receiptDigests: [input.digest]
+  };
+  const artifact = (kind, id2, content) => ({
+    kind,
+    id: id2,
+    sourceRevision: revision,
+    provenance: promotionProvenance,
+    content: (0, import_promotion.canonicalPromotionValue)(content)
+  });
+  const chapterId = document.target.chapterId;
+  const artifacts = [
+    artifact("chapter.catalog", chapterId, {
+      chapterId,
+      tiers: document.tiers.map(({ stripePriceId: _providerId, ...tier }) => tier)
+    }),
+    artifact("chapter.membership-page", chapterId, document.membershipPage),
+    ...document.application ? [artifact("chapter.application", chapterId, document.application)] : [],
+    ...document.policy ? [artifact("chapter.policy", chapterId, document.policy)] : [],
+    ...document.scheduling ? [artifact("chapter.scheduling", chapterId, document.scheduling)] : [],
+    ...document.theme ? [artifact("chapter.theme", chapterId, document.theme)] : []
+  ];
+  return {
+    adapter: CHAPTER_PROMOTION_ADAPTER,
+    artifacts,
+    exclusions: exclusions(chapterId, document.tiers.filter((tier) => tier.stripePriceId).map((tier) => tier.id)),
+    preconditions: [
+      {
+        code: "chapter.signup-control.schema",
+        path: "services.chapter.signupControl.schemaVersion",
+        expected: document.schemaVersion,
+        detail: "The target must support this Chapter signup-control document version."
+      },
+      {
+        code: "chapter.identity",
+        path: "app.appId",
+        expected: chapterId,
+        detail: "Chapter content can only target the chapter named by the signed source revision."
+      }
+    ]
+  };
+}
 //# sourceMappingURL=index.cjs.map