@topy-ai/maggie 0.7.47 → 0.7.49

package/bundled-contracts/maggiedash/booking-browser-evidence-v2.json

@@ -0,0 +1,191 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://maggiedash.topy.ai/contracts/booking-browser-evidence-v2.json",
+  "title": "MaggieDash Booking production browser evidence v2",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "baseUrl",
+    "generatedAt",
+    "viewports",
+    "screens",
+    "consoleErrors",
+    "failedRequests",
+    "layoutErrors"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "maggiedash-booking-browser-evidence.v2"
+    },
+    "baseUrl": {
+      "type": "string",
+      "pattern": "^https://"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "version": {
+      "type": "string"
+    },
+    "viewports": {
+      "type": "array",
+      "minItems": 3,
+      "items": {
+        "type": "object",
+        "required": [
+          "name",
+          "width",
+          "height"
+        ]
+      }
+    },
+    "screens": {
+      "type": "array",
+      "minItems": 51,
+      "items": {
+        "type": "object",
+        "required": [
+          "route",
+          "viewport",
+          "httpStatus",
+          "finalPath",
+          "heading",
+          "screenshot",
+          "ready"
+        ],
+        "properties": {
+          "route": {
+            "type": "string",
+            "enum": [
+              "/_maggie/booking/",
+              "/_maggie/booking/calendar",
+              "/_maggie/booking/bookings",
+              "/_maggie/booking/customers",
+              "/_maggie/booking/waitlist",
+              "/_maggie/booking/locations",
+              "/_maggie/booking/catalog",
+              "/_maggie/booking/packages",
+              "/_maggie/booking/staff",
+              "/_maggie/booking/resources",
+              "/_maggie/booking/schedule",
+              "/_maggie/booking/payments",
+              "/_maggie/booking/notifications",
+              "/_maggie/booking/email-templates",
+              "/_maggie/booking/reports",
+              "/_maggie/booking/settings",
+              "/_maggie/booking/audit"
+            ]
+          },
+          "viewport": {
+            "type": "string",
+            "enum": [
+              "mobile",
+              "tablet",
+              "desktop"
+            ]
+          },
+          "httpStatus": {
+            "type": "integer",
+            "minimum": 200,
+            "maximum": 399
+          },
+          "finalPath": {
+            "type": "string",
+            "pattern": "^/_maggie/booking(?:/|$)"
+          },
+          "heading": {
+            "type": "string",
+            "minLength": 1
+          },
+          "screenshot": {
+            "type": "string",
+            "minLength": 1
+          },
+          "ready": {
+            "const": true
+          }
+        }
+      }
+    },
+    "consoleErrors": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "failedRequests": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "layoutErrors": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "notes": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "x-required-routes": [
+    "/_maggie/booking/",
+    "/_maggie/booking/calendar",
+    "/_maggie/booking/bookings",
+    "/_maggie/booking/customers",
+    "/_maggie/booking/waitlist",
+    "/_maggie/booking/locations",
+    "/_maggie/booking/catalog",
+    "/_maggie/booking/packages",
+    "/_maggie/booking/staff",
+    "/_maggie/booking/resources",
+    "/_maggie/booking/schedule",
+    "/_maggie/booking/payments",
+    "/_maggie/booking/notifications",
+    "/_maggie/booking/email-templates",
+    "/_maggie/booking/reports",
+    "/_maggie/booking/settings",
+    "/_maggie/booking/audit"
+  ],
+  "x-required-viewports": [
+    {
+      "name": "mobile",
+      "width": 390,
+      "height": 844
+    },
+    {
+      "name": "tablet",
+      "width": 768,
+      "height": 1024
+    },
+    {
+      "name": "desktop",
+      "width": 1440,
+      "height": 1000
+    }
+  ],
+  "x-required-headings": {
+    "/_maggie/booking/": "Overview",
+    "/_maggie/booking/calendar": "Calendar",
+    "/_maggie/booking/bookings": "Bookings",
+    "/_maggie/booking/customers": "Customers",
+    "/_maggie/booking/waitlist": "Waitlist",
+    "/_maggie/booking/locations": "Locations",
+    "/_maggie/booking/catalog": "Catalogue",
+    "/_maggie/booking/packages": "Packages",
+    "/_maggie/booking/staff": "Staff",
+    "/_maggie/booking/resources": "Resources",
+    "/_maggie/booking/schedule": "Schedule",
+    "/_maggie/booking/payments": "Payments",
+    "/_maggie/booking/notifications": "Notifications",
+    "/_maggie/booking/email-templates": "Email templates",
+    "/_maggie/booking/reports": "Reports",
+    "/_maggie/booking/settings": "Settings",
+    "/_maggie/booking/audit": "Audit"
+  }
+}

package/bundled-contracts/maggiedash/booking-email-templates-v1.json

@@ -11,16 +11,18 @@
   },
   "roles": ["owner", "admin", "manager"],
   "events": [
-    { "id": "booking.confirmed", "variables": ["customerName", "serviceName", "when", "locationName", "bookingId", "manageUrl", "siteName"] },
+    { "id": "booking.confirmed", "variables": ["customerName", "serviceName", "when", "locationName", "bookingId", "manageUrl", "siteName", "arrivalNote"] },
     { "id": "booking.rescheduled", "variables": ["customerName", "serviceName", "when", "locationName", "bookingId", "manageUrl", "siteName"] },
     { "id": "booking.cancelled", "variables": ["customerName", "serviceName", "when", "locationName", "bookingId", "reason", "siteName"] },
     { "id": "booking.reminder", "variables": ["customerName", "serviceName", "when", "locationName", "bookingId", "manageUrl", "siteName"] },
     { "id": "payment.action_required", "variables": ["customerName", "serviceName", "bookingId", "actionUrl", "siteName"] },
     { "id": "payment.refunded", "variables": ["customerName", "serviceName", "bookingId", "siteName"] },
+    { "id": "payment.no_show_fee", "variables": ["customerName", "serviceName", "bookingId", "amount", "siteName"] },
     { "id": "package.purchase.confirmed", "variables": ["customerName", "packageName", "amount", "expiresAt", "siteName"] },
     { "id": "package.purchase.refunded", "variables": ["customerName", "packageName", "amount", "siteName"] },
     { "id": "booking.waitlist.available", "variables": ["customerName", "serviceName", "when", "locationName", "bookingUrl", "siteName"] }
   ],
+  "variables": ["customerName", "serviceName", "when", "locationName", "bookingId", "manageUrl", "bookingUrl", "reason", "actionUrl", "packageName", "amount", "expiresAt", "siteName", "arrivalNote"],
   "endpointIds": ["booking.email-templates.read", "booking.email-templates.draft", "booking.email-templates.publish", "booking.email-templates.rollback"],
   "canonicalRoutes": {
     "booking.email-templates.read": "GET /email-templates.json",

package/bundled-contracts/maggiedash/booking-voucher-lifecycle-v1.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://maggiedash.topy.ai/contracts/booking-voucher-lifecycle-v1.json",
+  "title": "MaggieDash Booking gift voucher lifecycle v1",
+  "schemaVersion": "maggiedash-booking-voucher-lifecycle.v1",
+  "status": "contract",
+  "runtime": {
+    "owner": "host",
+    "maggieDashRuntime": false,
+    "note": "This contract fixes the provider-neutral voucher lifecycle. MaggieDash does not ship a voucher runtime in this release; a host implements it and proves it with a sanitized ledger fixture."
+  },
+  "apiPrefix": "/api/maggie/booking/vouchers.json",
+  "auth": { "managerSession": "host-session-cookie", "emailPassword": true, "passkeys": false },
+  "permissions": ["vouchers.read", "vouchers.sell", "vouchers.redeem", "vouchers.void", "vouchers.refund"],
+  "money": { "unit": "minor", "integerOnly": true, "singleCurrencyPerVoucher": true },
+  "channels": {
+    "online": {
+      "funding": "provider-payment",
+      "issueAfter": "verified payment success webhook",
+      "provider": "stripe",
+      "providerObjects": ["checkout_sessions", "payment_intents", "refunds"],
+      "nativeGiftCards": false
+    },
+    "till": {
+      "funding": "recorded-in-shop-payment",
+      "paymentMethods": ["cash", "card-terminal", "external"],
+      "requiredPermission": "vouchers.sell"
+    }
+  },
+  "codeFormat": {
+    "online": {
+      "pattern": "^[A-Z]{2,4}-[A-Z2-9]{4}-[A-Z2-9]{4}-[A-Z2-9]{4}$",
+      "alphabet": "ABCDEFGHJKLMNPQRSTUVWXYZ23456789",
+      "check": "hmac-sha256",
+      "checkSegment": "last segment is a truncated HMAC of the body under a server-only secret; verify in constant time before any database lookup"
+    },
+    "till": {
+      "pattern": "^[A-Z]{1,4}[0-9]{6,10}$",
+      "check": "luhn",
+      "checkSegment": "final digit is a Luhn check digit so mistyped printed codes fail before lookup"
+    },
+    "storage": "store only codeHash and codeLast4; never persist or return the full code after delivery"
+  },
+  "states": ["pending_payment", "active", "exhausted", "expired", "voided", "refunded"],
+  "ledger": {
+    "appendOnly": true,
+    "entryTypes": ["issue", "redeem", "undo_redeem", "void", "expire", "refund"],
+    "balanceRule": "balance = issue - redeem + undo_redeem - refund; it never becomes negative",
+    "fields": ["id", "voucherId", "type", "amount", "at", "actorId", "idempotencyKey", "reverses", "bookingId", "paymentRef", "refundMethod", "reason"]
+  },
+  "rules": {
+    "issue": "exactly one issue entry, first in the ledger, equal to faceValue; online vouchers stay pending_payment until the verified payment webhook",
+    "partialRedemption": "a redemption may be any positive amount up to the remaining balance; the remainder stays redeemable",
+    "undo": "undo_redeem reverses exactly one earlier redeem entry by id, for the same amount, at most once, and never after void",
+    "void": "void requires a reason and blocks every later redemption, undo, and refund; the remaining balance is reported but unusable",
+    "expiry": "no redemption at or after expiresAt; an expire entry records the unused balance without changing the ledger history",
+    "refund": "refund amount is capped by the remaining balance and by the funded amount minus earlier refunds; online refunds reference the original provider payment; till refunds record refundMethod",
+    "fullRefund": "a refund that brings the balance to zero before any redemption moves the voucher to refunded"
+  },
+  "notifications": [
+    { "id": "voucher.purchase.confirmed", "recipient": "buyer", "variables": ["customerName", "amount", "voucherLast4", "expiresAt", "siteName"] },
+    { "id": "voucher.delivered", "recipient": "recipient", "variables": ["recipientName", "senderName", "message", "amount", "voucherCode", "expiresAt", "redeemUrl", "siteName"] },
+    { "id": "voucher.redeemed", "recipient": "buyer-or-recipient", "variables": ["amount", "remainingBalance", "voucherLast4", "siteName"] },
+    { "id": "voucher.refunded", "recipient": "buyer", "variables": ["customerName", "amount", "voucherLast4", "siteName"] },
+    { "id": "voucher.expiry_reminder", "recipient": "recipient", "variables": ["recipientName", "remainingBalance", "expiresAt", "redeemUrl", "siteName"] }
+  ],
+  "endpointIds": ["booking.vouchers.read", "booking.vouchers.sell", "booking.vouchers.redeem", "booking.vouchers.undo", "booking.vouchers.void", "booking.vouchers.refund"],
+  "canonicalRoutes": {
+    "booking.vouchers.read": "GET /vouchers.json",
+    "booking.vouchers.sell": "POST /vouchers.json?action=sell",
+    "booking.vouchers.redeem": "POST /vouchers.json?action=redeem",
+    "booking.vouchers.undo": "POST /vouchers.json?action=undo",
+    "booking.vouchers.void": "POST /vouchers.json?action=void",
+    "booking.vouchers.refund": "POST /vouchers.json?action=refund"
+  },
+  "policy": {
+    "tenantScoped": true,
+    "auditRequired": true,
+    "idempotencyRequiredForMutations": true,
+    "fullCodeOnlyInDeliveryEmail": true,
+    "providerCredentialsRemainServerOnly": true,
+    "expiryPolicyDeclaredByHost": true
+  },
+  "ledgerFixtureSchemaVersion": "maggiedash-booking-voucher-ledger.v1"
+}