@xapps-platform/xapp-manifest 0.2.1 → 0.2.4

package/dist/index.js

@@ -8090,6 +8090,20 @@ var xappManifestJsonSchema = {
       type: "object",
       additionalProperties: false,
       properties: {
+        virtual_currencies: {
+          type: "array",
+          maxItems: 200,
+          items: {
+            type: "object",
+            required: ["code"],
+            additionalProperties: false,
+            properties: {
+              code: { type: "string", minLength: 1, maxLength: 100 },
+              name: { type: "string", minLength: 1, maxLength: 200 },
+              status: { type: "string", enum: ["active", "archived"] }
+            }
+          }
+        },
         products: {
           type: "array",
           maxItems: 200,
@@ -8103,6 +8117,16 @@ var xappManifestJsonSchema = {
               description: localizedTextSchema(2e3),
               product_family: { type: "string", minLength: 1, maxLength: 100 },
               status: { type: "string", enum: ["draft", "active", "archived"] },
+              virtual_currency: {
+                type: "object",
+                additionalProperties: false,
+                required: ["code"],
+                properties: {
+                  code: { type: "string", minLength: 1, maxLength: 100 },
+                  name: { type: "string", minLength: 1, maxLength: 200 },
+                  status: { type: "string", enum: ["active", "archived"] }
+                }
+              },
               metadata: { type: "object" }
             }
           }
@@ -8158,6 +8182,7 @@ var xappManifestJsonSchema = {
               package_ref: { type: "string", minLength: 1, maxLength: 100 },
               currency: { type: "string", minLength: 1, maxLength: 16 },
               amount: { type: "number", minimum: 0 },
+              price_tax_mode: { type: "string", enum: ["gross", "net"] },
               billing_period: { type: "string", enum: ["day", "week", "month", "year"] },
               billing_period_count: { type: "integer", minimum: 1, maximum: 1e6 },
               trial_policy: { type: "object" },
@@ -8167,6 +8192,85 @@ var xappManifestJsonSchema = {
               metadata: { type: "object" }
             }
           }
+        },
+        paywalls: {
+          type: "array",
+          maxItems: 200,
+          items: {
+            type: "object",
+            required: ["slug", "offering_refs"],
+            additionalProperties: false,
+            properties: {
+              slug: { type: "string", minLength: 1, maxLength: 100 },
+              title: localizedTextSchema(200),
+              description: localizedTextSchema(2e3),
+              placement: { type: "string", minLength: 1, maxLength: 100 },
+              offering_refs: {
+                type: "array",
+                minItems: 1,
+                maxItems: 50,
+                items: { type: "string", minLength: 1, maxLength: 100 }
+              },
+              package_refs: {
+                type: "array",
+                minItems: 1,
+                maxItems: 200,
+                items: { type: "string", minLength: 1, maxLength: 100 }
+              },
+              default_package_ref: { type: "string", minLength: 1, maxLength: 100 },
+              status: { type: "string", enum: ["draft", "active", "archived"] },
+              targeting_rules: { type: "object" },
+              metadata: { type: "object" }
+            }
+          }
+        },
+        usage_policies: {
+          type: "array",
+          maxItems: 200,
+          items: {
+            type: "object",
+            required: ["tool_name", "credit_cost"],
+            additionalProperties: false,
+            properties: {
+              tool_name: { type: "string", minLength: 1, maxLength: 100 },
+              unit: { type: "string", minLength: 1, maxLength: 100 },
+              credit_cost: { type: "number", minimum: 0 },
+              virtual_currency_code: { type: "string", minLength: 1, maxLength: 100 },
+              status: { type: "string", enum: ["draft", "active", "archived"] },
+              metadata: { type: "object" }
+            }
+          }
+        },
+        hooks: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            after_payment_completed: {
+              type: "object",
+              additionalProperties: true,
+              properties: {
+                enabled: { type: "boolean" },
+                guard_slug: { type: "string", minLength: 1, maxLength: 200 },
+                guardSlug: { type: "string", minLength: 1, maxLength: 200 },
+                invoice_ref: { type: "string", minLength: 1, maxLength: 200 },
+                invoiceRef: { type: "string", minLength: 1, maxLength: 200 },
+                by_payment_guard_ref: {
+                  type: "object",
+                  additionalProperties: {
+                    type: "object",
+                    additionalProperties: true
+                  }
+                },
+                byPaymentGuardRef: {
+                  type: "object",
+                  additionalProperties: {
+                    type: "object",
+                    additionalProperties: true
+                  }
+                }
+              }
+            }
+          }
         }
       }
     },
@@ -8839,6 +8943,8 @@ function parseXappManifest(input, options) {
   const monetizationOfferings = readMonetizationEntries(monetization?.offerings);
   const monetizationPackages = readMonetizationEntries(monetization?.packages);
   const monetizationPrices = readMonetizationEntries(monetization?.prices);
+  const monetizationPaywalls = readMonetizationEntries(monetization?.paywalls);
+  const monetizationUsagePolicies = Array.isArray(monetization?.usage_policies) ? monetization.usage_policies : [];
   const paymentDefinitions = Array.isArray(manifest.payment_guard_definitions) ? manifest.payment_guard_definitions : [];
   const subjectProfileDefinitions = Array.isArray(manifest.subject_profile_guard_definitions) ? manifest.subject_profile_guard_definitions : [];
   const notificationDefinitions = Array.isArray(manifest.notification_definitions) ? manifest.notification_definitions : [];
@@ -8858,6 +8964,7 @@ function parseXappManifest(input, options) {
   );
   const monetizationPackageSlugs = requireUniqueSlug(monetizationPackages, "monetization.packages");
   requireUniqueSlug(monetizationPrices, "monetization.prices");
+  requireUniqueSlug(monetizationPaywalls, "monetization.paywalls");
   for (const list of [
     [paymentDefinitions, paymentDefinitionNames, "payment_guard_definitions"],
     [subjectProfileDefinitions, subjectProfileDefinitionNames, "subject_profile_guard_definitions"],
@@ -8902,6 +9009,30 @@ function parseXappManifest(input, options) {
   const knownToolNames = new Set(
     (manifest.tools ?? []).map((tool) => String(tool.tool_name || "").trim())
   );
+  const monetizationUsagePolicyTools = /* @__PURE__ */ new Set();
+  for (const usagePolicy of monetizationUsagePolicies) {
+    const toolName = String(usagePolicy?.tool_name ?? "").trim();
+    const creditCost = Number(usagePolicy?.credit_cost);
+    if (!knownToolNames.has(toolName)) {
+      throw Object.assign(
+        new Error(`monetization.usage_policies entry references unknown tool_name: ${toolName}`),
+        { status: 400 }
+      );
+    }
+    if (!Number.isFinite(creditCost)) {
+      throw Object.assign(
+        new Error(`monetization.usage_policies entry requires numeric credit_cost: ${toolName}`),
+        { status: 400 }
+      );
+    }
+    if (monetizationUsagePolicyTools.has(toolName)) {
+      throw Object.assign(
+        new Error(`monetization.usage_policies has duplicate tool_name: ${toolName}`),
+        { status: 400 }
+      );
+    }
+    monetizationUsagePolicyTools.add(toolName);
+  }
   const referencedPaymentDefinitionNames = /* @__PURE__ */ new Set();
   const referencedSubjectProfileDefinitionNames = /* @__PURE__ */ new Set();
   const notificationDefinitionRegistry = buildNotificationDefinitionRegistry(
@@ -8914,6 +9045,44 @@ function parseXappManifest(input, options) {
     manifest.invoice_definitions ?? []
   );
   const invoiceTemplateRegistry = buildInvoiceTemplateRegistry(manifest.invoice_templates ?? []);
+  const notificationTemplateFamilyNames = /* @__PURE__ */ new Map();
+  for (const template of notificationTemplates) {
+    const family = String(template?.family ?? "").trim();
+    const name = String(template?.name ?? "").trim();
+    if (!family || !name) continue;
+    notificationTemplateFamilyNames.set(family, [
+      ...notificationTemplateFamilyNames.get(family) ?? [],
+      name
+    ]);
+  }
+  const invoiceTemplateFamilyNames = /* @__PURE__ */ new Map();
+  for (const template of invoiceTemplates) {
+    const family = String(template?.family ?? "").trim();
+    const name = String(template?.name ?? "").trim();
+    if (!family || !name) continue;
+    invoiceTemplateFamilyNames.set(family, [
+      ...invoiceTemplateFamilyNames.get(family) ?? [],
+      name
+    ]);
+  }
+  const hasNotificationTemplateRef = (ref) => notificationTemplateRegistry.has(ref) || notificationTemplateFamilyNames.has(ref);
+  const hasInvoiceTemplateRef = (ref) => invoiceTemplateRegistry.has(ref) || invoiceTemplateFamilyNames.has(ref);
+  const markNotificationTemplateRef = (ref) => {
+    const familyNames = notificationTemplateFamilyNames.get(ref);
+    if (familyNames?.length) {
+      for (const name of familyNames) referencedNotificationTemplateNames.add(name);
+      return;
+    }
+    referencedNotificationTemplateNames.add(ref);
+  };
+  const markInvoiceTemplateRef = (ref) => {
+    const familyNames = invoiceTemplateFamilyNames.get(ref);
+    if (familyNames?.length) {
+      for (const name of familyNames) referencedInvoiceTemplateNames.add(name);
+      return;
+    }
+    referencedInvoiceTemplateNames.add(ref);
+  };
   const subjectProfileDefinitionRegistry = buildSubjectProfileDefinitionRegistry(
     manifest.subject_profile_guard_definitions ?? []
   );
@@ -8924,8 +9093,8 @@ function parseXappManifest(input, options) {
   for (const def of notificationDefinitions) {
     const templateRef = readNotificationTemplateRef(def);
     if (!templateRef) continue;
-    referencedNotificationTemplateNames.add(templateRef);
-    if (!notificationTemplateRegistry.has(templateRef)) {
+    markNotificationTemplateRef(templateRef);
+    if (!hasNotificationTemplateRef(templateRef)) {
       throw Object.assign(
         new Error(
           `notification_definitions entry ${String(def?.name ?? "unknown")} references unknown template_ref: ${templateRef}`
@@ -8937,8 +9106,8 @@ function parseXappManifest(input, options) {
   for (const def of invoiceDefinitions) {
     const templateRef = readInvoiceTemplateRef(def);
     if (!templateRef) continue;
-    referencedInvoiceTemplateNames.add(templateRef);
-    if (!invoiceTemplateRegistry.has(templateRef)) {
+    markInvoiceTemplateRef(templateRef);
+    if (!hasInvoiceTemplateRef(templateRef)) {
       throw Object.assign(
         new Error(
           `invoice_definitions entry ${String(def?.name ?? "unknown")} references unknown invoice_template_ref: ${templateRef}`
@@ -8983,6 +9152,102 @@ function parseXappManifest(input, options) {
       );
     }
   }
+  const packageOfferingBySlug = /* @__PURE__ */ new Map();
+  for (const monetizationPackage of monetizationPackages) {
+    const packageSlug = String(monetizationPackage.slug ?? "").trim();
+    const offeringRef = String(monetizationPackage.offering_ref ?? "").trim();
+    if (packageSlug && offeringRef) {
+      packageOfferingBySlug.set(packageSlug, offeringRef);
+    }
+  }
+  for (const monetizationPaywall of monetizationPaywalls) {
+    const paywallSlug = String(monetizationPaywall.slug ?? "unknown").trim() || "unknown";
+    const offeringRefs = Array.isArray(monetizationPaywall.offering_refs) ? monetizationPaywall.offering_refs.map((value) => String(value ?? "").trim()).filter(Boolean) : [];
+    if (!offeringRefs.length) {
+      throw Object.assign(
+        new Error(`monetization.paywalls entry ${paywallSlug} requires at least one offering_ref`),
+        { status: 400 }
+      );
+    }
+    const offeringRefSet = /* @__PURE__ */ new Set();
+    for (const offeringRef of offeringRefs) {
+      if (!monetizationOfferingSlugs.has(offeringRef)) {
+        throw Object.assign(
+          new Error(
+            `monetization.paywalls entry ${paywallSlug} references unknown offering_ref: ${offeringRef}`
+          ),
+          { status: 400 }
+        );
+      }
+      if (offeringRefSet.has(offeringRef)) {
+        throw Object.assign(
+          new Error(
+            `monetization.paywalls entry ${paywallSlug} has duplicate offering_ref: ${offeringRef}`
+          ),
+          { status: 400 }
+        );
+      }
+      offeringRefSet.add(offeringRef);
+    }
+    const packageRefs = Array.isArray(monetizationPaywall.package_refs) ? monetizationPaywall.package_refs.map((value) => String(value ?? "").trim()).filter(Boolean) : [];
+    const packageRefSet = /* @__PURE__ */ new Set();
+    for (const packageRef of packageRefs) {
+      if (!monetizationPackageSlugs.has(packageRef)) {
+        throw Object.assign(
+          new Error(
+            `monetization.paywalls entry ${paywallSlug} references unknown package_ref: ${packageRef}`
+          ),
+          { status: 400 }
+        );
+      }
+      if (packageRefSet.has(packageRef)) {
+        throw Object.assign(
+          new Error(
+            `monetization.paywalls entry ${paywallSlug} has duplicate package_ref: ${packageRef}`
+          ),
+          { status: 400 }
+        );
+      }
+      packageRefSet.add(packageRef);
+      const packageOfferingRef = String(packageOfferingBySlug.get(packageRef) ?? "").trim();
+      if (packageOfferingRef && !offeringRefSet.has(packageOfferingRef)) {
+        throw Object.assign(
+          new Error(
+            `monetization.paywalls entry ${paywallSlug} package_ref ${packageRef} is not inside paywall offering_refs`
+          ),
+          { status: 400 }
+        );
+      }
+    }
+    const defaultPackageRef = String(monetizationPaywall.default_package_ref ?? "").trim();
+    if (defaultPackageRef) {
+      if (!monetizationPackageSlugs.has(defaultPackageRef)) {
+        throw Object.assign(
+          new Error(
+            `monetization.paywalls entry ${paywallSlug} references unknown default_package_ref: ${defaultPackageRef}`
+          ),
+          { status: 400 }
+        );
+      }
+      if (packageRefSet.size > 0 && !packageRefSet.has(defaultPackageRef)) {
+        throw Object.assign(
+          new Error(
+            `monetization.paywalls entry ${paywallSlug} default_package_ref must also exist in package_refs when package_refs are declared`
+          ),
+          { status: 400 }
+        );
+      }
+      const defaultOfferingRef = String(packageOfferingBySlug.get(defaultPackageRef) ?? "").trim();
+      if (defaultOfferingRef && !offeringRefSet.has(defaultOfferingRef)) {
+        throw Object.assign(
+          new Error(
+            `monetization.paywalls entry ${paywallSlug} default_package_ref ${defaultPackageRef} is not inside paywall offering_refs`
+          ),
+          { status: 400 }
+        );
+      }
+    }
+  }
   for (const tool of manifest.tools ?? []) {
     validateAdapterShape(tool);
     const policy = tool.dispatch_policy;
@@ -9069,8 +9334,8 @@ function parseXappManifest(input, options) {
     const resolvedHookFamilyConfig = resolvedNotificationConfig ?? resolvedInvoiceConfig;
     const templateRef = resolvedNotificationConfig && isRecord(resolvedNotificationConfig) ? readNotificationTemplateRef(resolvedNotificationConfig) : "";
     if (templateRef) {
-      referencedNotificationTemplateNames.add(templateRef);
-      if (!notificationTemplateRegistry.has(templateRef)) {
+      markNotificationTemplateRef(templateRef);
+      if (!hasNotificationTemplateRef(templateRef)) {
         throw Object.assign(
           new Error(
             `Guard ${String(guard?.slug || "unknown")} references unknown template_ref: ${templateRef}`
@@ -9081,8 +9346,8 @@ function parseXappManifest(input, options) {
     }
     const invoiceTemplateRef = resolvedInvoiceConfig && isRecord(resolvedInvoiceConfig) ? readInvoiceTemplateRef(resolvedInvoiceConfig) : readInvoiceTemplateRef(guardConfig);
     if (invoiceTemplateRef) {
-      referencedInvoiceTemplateNames.add(invoiceTemplateRef);
-      if (!invoiceTemplateRegistry.has(invoiceTemplateRef)) {
+      markInvoiceTemplateRef(invoiceTemplateRef);
+      if (!hasInvoiceTemplateRef(invoiceTemplateRef)) {
         throw Object.assign(
           new Error(
             `Guard ${String(guard?.slug || "unknown")} references unknown invoice_template_ref: ${invoiceTemplateRef}`