@saasicat/ui-vue 1.0.0-rc.27 → 1.0.0-rc.28

package/dist/.build-stamp

@@ -1 +1 @@
-c73a35418edcd721cad98a0eaee386b305881f4dfe1d7a74c2c51ef50ba348d4
+25d9bdf300afc11738864821176eeb1949f0583fdb0bc06d0c8dbdd7019c8c7c

package/dist/assets/ui-vue.css

@@ -6916,6 +6916,29 @@ code[data-v-aab75c67] {
     font-size: var(--sa-text-md);
 }
 
+.sa-invoice-cancel__lines[data-v-c2083b50] {
+    list-style: none;
+    margin: var(--sa-space-2) 0 0;
+    padding: 0;
+    display: grid;
+    gap: var(--sa-space-2);
+}
+.sa-invoice-cancel__line[data-v-c2083b50] {
+    display: flex;
+    justify-content: space-between;
+    gap: var(--sa-space-3);
+}
+
+.sa-invoice-cancel__figures[data-v-47173c72] {
+    display: grid;
+    grid-template-columns: max-content 1fr;
+    gap: var(--sa-space-1) var(--sa-space-3);
+    margin: var(--sa-space-2) 0 0;
+}
+.sa-invoice-cancel__figures dd[data-v-47173c72] {
+    margin: 0;
+}
+
 .sa-tenant-subscriber__note[data-v-2e8dc554] {
     color: var(--sa-color-fg-muted);
     margin: 0;
@@ -6925,7 +6948,7 @@ code[data-v-aab75c67] {
     padding-left: var(--sa-space-4);
 }
 
-code[data-v-6eaf92ec] {
+code[data-v-73185124] {
     background: var(--sa-color-bg-sunken);
     padding: var(--sa-space-0) var(--sa-space-2);
     border-radius: var(--sa-radius-badge);

package/dist/{catalog-DwUIt-lr.d.cts → catalog-DheYUn-o.d.cts}

@@ -1,5 +1,5 @@
 import * as _saasicat_core from '@saasicat/core';
-import { FeatureWithdrawalReduction, FeatureWithdrawalView, FeatureWithdrawalPreview, FeatureWithdrawalAnnounced, FeatureWithdrawalLifted, BundleVersionRetirementView, BundleRetirementPreview, BundleRetirementAnnounced, VersionRetirementView, RetirementPreview, RetirementAnnounced, MaintenanceOverview, MaintenanceWindowView, MaintenanceLockView, MaintenanceUnlockView, AdminAuditListFilter, AuditEntry, TenantListFilter, TenantDto, AdminTenantDetail, AdminSubscriberAccount, AdminSubscriberCredits, AdminTenantPayments, AdminSubscriberPayout, AdminTenantSubscriber, AdminSubscriberHistoryEntry, AdminSubscriberCorrected, AdminSubscriberAttention, PromoCodeRecord, MarketingProjectionRow, CreateMarketingProjectionData, UpdateMarketingProjectionData, MarketingSettingsRow, DiscoverySnapshot, KpiCardDef, BundleVersionRow, CreateBundleVersionDraftData, BundleVersionMutationResult, UpdateBundleVersionDraftData, BundleRow, CreateBundleData, UpdateBundleData, PlanVersionRow, CreatePlanVersionDraftData, PlanVersionMutationResult, UpdatePlanVersionDraftData, PlanRow, CreatePlanData, UpdatePlanData, StandardPageKey, AdminManifest, TenantActionDef } from '@saasicat/core';
+import { FeatureWithdrawalReduction, FeatureWithdrawalView, FeatureWithdrawalPreview, FeatureWithdrawalAnnounced, FeatureWithdrawalLifted, BundleVersionRetirementView, BundleRetirementPreview, BundleRetirementAnnounced, VersionRetirementView, RetirementPreview, RetirementAnnounced, MaintenanceOverview, MaintenanceWindowView, MaintenanceLockView, MaintenanceUnlockView, AdminAuditListFilter, AuditEntry, TenantListFilter, TenantDto, AdminTenantDetail, AdminSubscriberAccount, AdminSubscriberCredits, AdminTenantPayments, AdminTenantContracts, AdminSubscriberPayout, AdminInvoice, InvoiceCancellationRequest, AdminInvoiceCancellationPlan, AdminCancelledInvoice, AdminTenantSubscriber, AdminSubscriberHistoryEntry, AdminSubscriberCorrected, AdminSubscriberAttention, PromoCodeRecord, MarketingProjectionRow, CreateMarketingProjectionData, UpdateMarketingProjectionData, MarketingSettingsRow, DiscoverySnapshot, KpiCardDef, BundleVersionRow, CreateBundleVersionDraftData, BundleVersionMutationResult, UpdateBundleVersionDraftData, BundleRow, CreateBundleData, UpdateBundleData, PlanVersionRow, CreatePlanVersionDraftData, PlanVersionMutationResult, UpdatePlanVersionDraftData, PlanRow, CreatePlanData, UpdatePlanData, StandardPageKey, AdminManifest, TenantActionDef } from '@saasicat/core';
 
 /**
  * Minimal abstraction over `fetch`. Consumers may pass their own
@@ -10,6 +10,12 @@ type HttpClient = (url: string, init?: {
     method?: string;
     headers?: Record<string, string>;
     body?: string;
+    /**
+     * The answer is a file, such as an invoice's document: ask for its
+     * body as it arrived, which `HttpResponse.bytes` then hands over. A
+     * client that leaves this out still serves every other request.
+     */
+    binary?: boolean;
 }) => Promise<HttpResponse>;
 interface HttpResponse {
     status: number;
@@ -18,6 +24,11 @@ interface HttpResponse {
     };
     json(): Promise<unknown>;
     text(): Promise<string>;
+    /**
+     * The body as it arrived, for a request made with `binary`. Optional: only
+     * the downloads ask for it, and they say so where a client has none.
+     */
+    bytes?(): Promise<Uint8Array>;
 }
 /** Simple persistence adapter; default is `localStorage`. */
 interface KvStore {
@@ -386,6 +397,56 @@ declare const auditResource: ResourceDef<{
     readonly list: (http: HttpClient, ctx: ResourceContext, filter?: AuditListFilter) => Promise<AuditEntry[]>;
 }>;
 
+interface ResourceRequestInit {
+    /** Default `GET`. */
+    method?: string;
+    /** Serialised here — the `HttpClient` contract only carries strings. */
+    body?: unknown;
+    /** Merged over the defaults, so a caller's header wins. */
+    headers?: Record<string, string>;
+}
+/**
+ * Sends a request and returns the parsed body, or `null` when there was none.
+ *
+ * `null` covers both a `204` and a 2xx whose body would not parse. The two are
+ * deliberately not distinguished: every caller treats them the same way — a
+ * list turns `null` into `[]`, a mutation turns it into a failure — and no
+ * endpoint in this family answers a mutation with an empty 200 on purpose.
+ *
+ * A non-2xx throws an `AdminError` carrying the parsed body, so a caller can
+ * still branch on `status` and `body.code` the way the pages do today.
+ *
+ * A client that resolved without an HTTP status throws before any of that: no
+ * status means the request never reached the server, which is a transport
+ * failure and not an answer this function may read.
+ */
+declare function requestJson<T>(http: HttpClient, url: string, init?: ResourceRequestInit): Promise<T | null>;
+/** A file a download answered: its bytes, its media type and the name it is offered under. */
+interface DownloadedFile {
+    content: Uint8Array;
+    mediaType: string;
+    fileName: string;
+}
+/**
+ * Downloads the file `url` answers, such as an invoice's archived document. A
+ * refusal is thrown as `requestJson` throws it, from the JSON body the server
+ * answers a refusal with. The name is the one `Content-Disposition` offers, or
+ * `fallbackName` where it offers none.
+ *
+ * Needs a client whose responses have `bytes()`: both clients the package
+ * ships do. One of the application's own that has none is said, rather than
+ * read through `text()`, which would hand a PDF over decoded as UTF-8.
+ */
+declare function requestFile(http: HttpClient, url: string, fallbackName: string): Promise<DownloadedFile>;
+/**
+ * Reads the body of a request that must answer with one.
+ *
+ * The empty case is a failure rather than a `null` the caller has to re-check:
+ * a create that returns nothing has not told us what it created. Raised with
+ * `status: 0`, because no HTTP status went wrong — the response was a 2xx.
+ */
+declare function requestJsonBody<T>(http: HttpClient, url: string, what: string, init?: ResourceRequestInit): Promise<T>;
+
 /** 1-based: the page a list starts on, and the one a changed filter returns to. */
 declare const LIST_FIRST_PAGE = 1;
 /**
@@ -532,12 +593,48 @@ declare const tenantsResource: ResourceDef<{
      * `payments.read`.
      */
     readonly payments: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<AdminTenantPayments>;
+    /**
+     * The tenant's contracts, the newest first, each with where its
+     * confirmation stands. Served only where the manifest announces
+     * `contracts.read`.
+     */
+    readonly contracts: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<AdminTenantContracts>;
+    /**
+     * The archived confirmation of one contract, the file its subscriber was
+     * sent. Served where the manifest announces `contracts.read`.
+     */
+    readonly contractConfirmation: (http: HttpClient, ctx: ResourceContext, contractId: string) => Promise<DownloadedFile>;
+    /**
+     * The archived document of one invoice, the file it was issued as. Served
+     * where the manifest announces `invoices.read`.
+     */
+    readonly invoiceDocument: (http: HttpClient, ctx: ResourceContext, invoiceId: string) => Promise<DownloadedFile>;
     /**
      * Records a payout made outside the gateway against one credit, and
      * answers the credits as they stand after it. Requires the second factor;
      * served where the manifest announces `credits.payout`.
      */
     readonly recordPayout: (http: HttpClient, ctx: ResourceContext, slug: string, creditId: string, payout: AdminSubscriberPayout, mfaCode?: string) => Promise<AdminSubscriberCredits>;
+    /**
+     * One of the tenant's invoices with its lines, each with what its charge
+     * stands at and whether a cancellation may correct it. Served where the
+     * manifest announces `invoices.cancel`.
+     */
+    readonly invoice: (http: HttpClient, ctx: ResourceContext, slug: string, invoiceId: string) => Promise<AdminInvoice>;
+    /**
+     * What cancelling one of the tenant's invoices would write — the
+     * cancellation invoice, the replacement and where what was paid goes —,
+     * computed as the cancellation computes it and refused as it is; nothing
+     * is written. Served where the manifest announces `invoices.cancel`.
+     */
+    readonly previewInvoiceCancellation: (http: HttpClient, ctx: ResourceContext, slug: string, invoiceId: string, request: InvoiceCancellationRequest) => Promise<AdminInvoiceCancellationPlan>;
+    /**
+     * Cancels one of the tenant's invoices by a cancellation invoice and its
+     * replacement. Requires the second factor; the request carries the
+     * preview's digest, and a preview that no longer holds is refused with the
+     * new one.
+     */
+    readonly cancelInvoice: (http: HttpClient, ctx: ResourceContext, slug: string, invoiceId: string, request: InvoiceCancellationRequest, mfaCode?: string) => Promise<AdminCancelledInvoice>;
     /**
      * The tenant's subscriber, its tax details and what holds its next
      * contract back. Served only where the manifest announces
@@ -862,7 +959,13 @@ declare const platformResources: {
         readonly charges: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<_saasicat_core.AdminSubscriberAccount>;
         readonly credits: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<_saasicat_core.AdminSubscriberCredits>;
         readonly payments: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<_saasicat_core.AdminTenantPayments>;
+        readonly contracts: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<_saasicat_core.AdminTenantContracts>;
+        readonly contractConfirmation: (http: HttpClient, ctx: ResourceContext, contractId: string) => Promise<DownloadedFile>;
+        readonly invoiceDocument: (http: HttpClient, ctx: ResourceContext, invoiceId: string) => Promise<DownloadedFile>;
         readonly recordPayout: (http: HttpClient, ctx: ResourceContext, slug: string, creditId: string, payout: _saasicat_core.AdminSubscriberPayout, mfaCode?: string) => Promise<_saasicat_core.AdminSubscriberCredits>;
+        readonly invoice: (http: HttpClient, ctx: ResourceContext, slug: string, invoiceId: string) => Promise<_saasicat_core.AdminInvoice>;
+        readonly previewInvoiceCancellation: (http: HttpClient, ctx: ResourceContext, slug: string, invoiceId: string, request: _saasicat_core.InvoiceCancellationRequest) => Promise<_saasicat_core.AdminInvoiceCancellationPlan>;
+        readonly cancelInvoice: (http: HttpClient, ctx: ResourceContext, slug: string, invoiceId: string, request: _saasicat_core.InvoiceCancellationRequest, mfaCode?: string) => Promise<_saasicat_core.AdminCancelledInvoice>;
         readonly subscriber: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<_saasicat_core.AdminTenantSubscriber>;
         readonly subscriberHistory: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<_saasicat_core.AdminSubscriberHistoryEntry[]>;
         readonly correctSubscriberIdentity: (http: HttpClient, ctx: ResourceContext, slug: string, correction: SubscriberIdentityCorrectionInput, mfaCode?: string) => Promise<_saasicat_core.AdminSubscriberCorrected>;
@@ -1538,6 +1641,7 @@ declare const errorsMessages: Record<SaBuiltinLocale, {
     server: string;
     httpStatus: string;
     unexpected: string;
+    codes: Record<_saasicat_core.PlatformErrorCode, string>;
 }>;
 
 declare const featureWithdrawalsMessages: Record<SaBuiltinLocale, {
@@ -2767,6 +2871,7 @@ declare const tenantsMessages: Record<SaBuiltinLocale, {
         fromPayment: string;
         fromInvoice: string;
         fromReversal: string;
+        fromCancellation: string;
         unknownInvoice: string;
         payOut: string;
         mfaPayout: string;
@@ -2796,6 +2901,102 @@ declare const tenantsMessages: Record<SaBuiltinLocale, {
         columnOwed: string;
         casesTitle: string;
         casesEmpty: string;
+        columnStanding: string;
+        cancellationOf: string;
+        replacementOf: string;
+        cancelledBy: string;
+        cancel: string;
+        cancelInvoice: string;
+        download: string;
+        downloadInvoice: string;
+        mfaCancel: string;
+        cancelled: string;
+        cancelledWithoutReplacement: string;
+        cancelDialog: {
+            askSubtitle: string;
+            reason: string;
+            reasonHint: string;
+            lines: string;
+            linesCaption: string;
+            linesLoadFailed: string;
+            lineChoice: string;
+            lineOwed: string;
+            lineNotOwed: string;
+            linePart: string;
+            lineAmount: string;
+            lineAmountHint: string;
+            lineFollows: string;
+            lineCorrection: string;
+            lineNothing: string;
+            movedLines: string;
+            movedLine: string;
+            replacementLines: string;
+            deliverTo: string;
+            deliverToHint: string;
+            corrections: string;
+            correctionsCaption: string;
+            onRecord: string;
+            onRecordEmpty: string;
+            takeOver: string;
+            takeOverLabel: string;
+            cleared: string;
+            preview: string;
+            previewSubtitle: string;
+            cancellationInvoice: string;
+            replacement: string;
+            noReplacement: string;
+            amounts: string;
+            tax: string;
+            dates: string;
+            movedIn: string;
+            credited: string;
+            deliveredTo: string;
+            toRecord: string;
+            party: string;
+            changed: string;
+            none: string;
+            back: string;
+            submit: string;
+            previewChanged: string;
+            taxTreatment: {
+                standard: string;
+                reduced: string;
+                exempt: string;
+                'reverse-charge': string;
+                'not-taxable': string;
+                'small-business': string;
+            };
+        };
+    };
+    contracts: {
+        title: string;
+        subtitle: string;
+        loadFailed: string;
+        empty: string;
+        columnConcluded: string;
+        columnStart: string;
+        columnStatus: string;
+        columnBilling: string;
+        columnTotal: string;
+        columnTerms: string;
+        columnNotice: string;
+        columnConfirmation: string;
+        noTerms: string;
+        noticeDays: string;
+        statuses: {
+            active: string;
+            scheduled: string;
+            terminated: string;
+            superseded: string;
+        };
+        states: {
+            'not-due': string;
+            'being-made': string;
+            'awaiting-mail': string;
+            sent: string;
+        };
+        download: string;
+        downloadConfirmation: string;
     };
     subscriber: {
         title: string;
@@ -2865,6 +3066,7 @@ declare const tenantsMessages: Record<SaBuiltinLocale, {
         };
         field: {
             addressLine1: string;
+            addressLine2: string;
             postalCode: string;
             city: string;
             country: string;
@@ -3058,4 +3260,4 @@ interface SaCatalog {
  */
 declare function createSaCatalog(options?: SaCatalogOptions): SaCatalog;
 
-export { type ResourceOps as $, ActionDefNotInManifestError as A, type Bound as B, type PilotEditPayload as C, DEFAULT_SA_LOCALE as D, type EmailHistoryDetail as E, type FeatureWithdrawalAnnouncementInput as F, type PilotEditResult as G, type HttpClient as H, type PilotRow as I, type PlatformEmailProvider as J, type KpiReading as K, LIST_FIRST_PAGE as L, type MaintenanceAnnouncementInput as M, type PlatformEmailTestInput as N, type PlatformEmailTestResult as O, type PartialMessages as P, type PlatformEmailWriteInput as Q, type PlatformResources as R, type PromoCodesFilter as S, type PromoDetail as T, type PublishBundleVersionOptions as U, type PublishPlanVersionOptions as V, type ResolvedAction as W, type ResourceContext as X, type ResourceDef as Y, type ResourceListPage as Z, type ResourceOp as _, type ActionHandler as a, type RetirementAnnouncement as a0, SA_INTL_LOCALES as a1, SA_LOCALES as a2, SA_LOCALE_LABELS as a3, SA_MESSAGES as a4, type SaBuiltinLocale as a5, type SaCatalog as a6, type SaCatalogOptions as a7, type SaLocale as a8, type SaLocaleDefinition as a9, isMaintenanceOverview as aA, isSaBuiltinLocale as aB, isSentInQuery as aC, listUrl as aD, maintenanceResource as aE, marketingResource as aF, mergeMessages as aG, planVersionsResource as aH, plansResource as aI, platformResources as aJ, promoCodesResource as aK, readListPage as aL, resolveMessages as aM, settingsResource as aN, tenantsResource as aO, versionRetirementsResource as aP, type SaNavMessages as aQ, type SaLocaleOption as aa, type SaMessages as ab, type SaMessagesOverrides as ac, type SettingsChangeView as ad, type SettingsDifferenceView as ae, type SubscriberBusinessStatusInput as af, type SubscriberIdentityCorrectionInput as ag, type TenantsListFilter as ah, type TranslationOf as ai, auditResource as aj, bindResource as ak, bundleVersionRetirementsResource as al, bundleVersionsResource as am, bundlesResource as an, clampListPage as ao, clampListPageSize as ap, createSaCatalog as aq, dashboardResource as ar, defaultHttpClient as as, defaultKvStore as at, defineListOp as au, defineMessages as av, defineResource as aw, discoveryResource as ax, featureWithdrawalsResource as ay, filterQueryString as az, ActionRegistry as b, type AppliedSettingsView as c, type AuditListFilter as d, type BundleRetirementAnnouncement as e, type DiscoveryRead as f, type EmailHistoryFilter as g, type EmailHistoryListResult as h, type EmailHistoryResendResult as i, type EmailHistoryRow as j, type EmailHistoryStatus as k, type HttpResponse as l, type KvStore as m, LIST_PAGE_SIZE_DEFAULT as n, LIST_PAGE_SIZE_MAX as o, LIST_PAGINATION_PARAMS as p, type ListFilterOf as q, type ListOp as r, type ListQuery as s, type MaintenanceLockInput as t, type MaintenanceRevisionInput as u, type MarketingProjectionsFilter as v, type MessageTree as w, MissingHandlerError as x, type PilotCreatePayload as y, type PilotCreateResult as z };
+export { type ResourceOp as $, ActionDefNotInManifestError as A, type Bound as B, type PilotCreateResult as C, DEFAULT_SA_LOCALE as D, type EmailHistoryDetail as E, type FeatureWithdrawalAnnouncementInput as F, type PilotEditPayload as G, type HttpClient as H, type PilotEditResult as I, type PilotRow as J, type KpiReading as K, LIST_FIRST_PAGE as L, type MaintenanceAnnouncementInput as M, type PlatformEmailProvider as N, type PlatformEmailTestInput as O, type PartialMessages as P, type PlatformEmailTestResult as Q, type PlatformEmailWriteInput as R, type PlatformResources as S, type PromoCodesFilter as T, type PromoDetail as U, type PublishBundleVersionOptions as V, type PublishPlanVersionOptions as W, type ResolvedAction as X, type ResourceContext as Y, type ResourceDef as Z, type ResourceListPage as _, type ActionHandler as a, type ResourceOps as a0, type ResourceRequestInit as a1, type RetirementAnnouncement as a2, SA_INTL_LOCALES as a3, SA_LOCALES as a4, SA_LOCALE_LABELS as a5, SA_MESSAGES as a6, type SaBuiltinLocale as a7, type SaCatalog as a8, type SaCatalogOptions as a9, featureWithdrawalsResource as aA, filterQueryString as aB, isMaintenanceOverview as aC, isSaBuiltinLocale as aD, isSentInQuery as aE, listUrl as aF, maintenanceResource as aG, marketingResource as aH, mergeMessages as aI, planVersionsResource as aJ, plansResource as aK, platformResources as aL, promoCodesResource as aM, readListPage as aN, requestFile as aO, requestJson as aP, requestJsonBody as aQ, resolveMessages as aR, settingsResource as aS, tenantsResource as aT, versionRetirementsResource as aU, type SaNavMessages as aV, type SaLocale as aa, type SaLocaleDefinition as ab, type SaLocaleOption as ac, type SaMessages as ad, type SaMessagesOverrides as ae, type SettingsChangeView as af, type SettingsDifferenceView as ag, type SubscriberBusinessStatusInput as ah, type SubscriberIdentityCorrectionInput as ai, type TenantsListFilter as aj, type TranslationOf as ak, auditResource as al, bindResource as am, bundleVersionRetirementsResource as an, bundleVersionsResource as ao, bundlesResource as ap, clampListPage as aq, clampListPageSize as ar, createSaCatalog as as, dashboardResource as at, defaultHttpClient as au, defaultKvStore as av, defineListOp as aw, defineMessages as ax, defineResource as ay, discoveryResource as az, ActionRegistry as b, type AppliedSettingsView as c, type AuditListFilter as d, type BundleRetirementAnnouncement as e, type DiscoveryRead as f, type DownloadedFile as g, type EmailHistoryFilter as h, type EmailHistoryListResult as i, type EmailHistoryResendResult as j, type EmailHistoryRow as k, type EmailHistoryStatus as l, type HttpResponse as m, type KvStore as n, LIST_PAGE_SIZE_DEFAULT as o, LIST_PAGE_SIZE_MAX as p, LIST_PAGINATION_PARAMS as q, type ListFilterOf as r, type ListOp as s, type ListQuery as t, type MaintenanceLockInput as u, type MaintenanceRevisionInput as v, type MarketingProjectionsFilter as w, type MessageTree as x, MissingHandlerError as y, type PilotCreatePayload as z };

package/dist/{catalog-DwUIt-lr.d.ts → catalog-DheYUn-o.d.ts}

@@ -1,5 +1,5 @@
 import * as _saasicat_core from '@saasicat/core';
-import { FeatureWithdrawalReduction, FeatureWithdrawalView, FeatureWithdrawalPreview, FeatureWithdrawalAnnounced, FeatureWithdrawalLifted, BundleVersionRetirementView, BundleRetirementPreview, BundleRetirementAnnounced, VersionRetirementView, RetirementPreview, RetirementAnnounced, MaintenanceOverview, MaintenanceWindowView, MaintenanceLockView, MaintenanceUnlockView, AdminAuditListFilter, AuditEntry, TenantListFilter, TenantDto, AdminTenantDetail, AdminSubscriberAccount, AdminSubscriberCredits, AdminTenantPayments, AdminSubscriberPayout, AdminTenantSubscriber, AdminSubscriberHistoryEntry, AdminSubscriberCorrected, AdminSubscriberAttention, PromoCodeRecord, MarketingProjectionRow, CreateMarketingProjectionData, UpdateMarketingProjectionData, MarketingSettingsRow, DiscoverySnapshot, KpiCardDef, BundleVersionRow, CreateBundleVersionDraftData, BundleVersionMutationResult, UpdateBundleVersionDraftData, BundleRow, CreateBundleData, UpdateBundleData, PlanVersionRow, CreatePlanVersionDraftData, PlanVersionMutationResult, UpdatePlanVersionDraftData, PlanRow, CreatePlanData, UpdatePlanData, StandardPageKey, AdminManifest, TenantActionDef } from '@saasicat/core';
+import { FeatureWithdrawalReduction, FeatureWithdrawalView, FeatureWithdrawalPreview, FeatureWithdrawalAnnounced, FeatureWithdrawalLifted, BundleVersionRetirementView, BundleRetirementPreview, BundleRetirementAnnounced, VersionRetirementView, RetirementPreview, RetirementAnnounced, MaintenanceOverview, MaintenanceWindowView, MaintenanceLockView, MaintenanceUnlockView, AdminAuditListFilter, AuditEntry, TenantListFilter, TenantDto, AdminTenantDetail, AdminSubscriberAccount, AdminSubscriberCredits, AdminTenantPayments, AdminTenantContracts, AdminSubscriberPayout, AdminInvoice, InvoiceCancellationRequest, AdminInvoiceCancellationPlan, AdminCancelledInvoice, AdminTenantSubscriber, AdminSubscriberHistoryEntry, AdminSubscriberCorrected, AdminSubscriberAttention, PromoCodeRecord, MarketingProjectionRow, CreateMarketingProjectionData, UpdateMarketingProjectionData, MarketingSettingsRow, DiscoverySnapshot, KpiCardDef, BundleVersionRow, CreateBundleVersionDraftData, BundleVersionMutationResult, UpdateBundleVersionDraftData, BundleRow, CreateBundleData, UpdateBundleData, PlanVersionRow, CreatePlanVersionDraftData, PlanVersionMutationResult, UpdatePlanVersionDraftData, PlanRow, CreatePlanData, UpdatePlanData, StandardPageKey, AdminManifest, TenantActionDef } from '@saasicat/core';
 
 /**
  * Minimal abstraction over `fetch`. Consumers may pass their own
@@ -10,6 +10,12 @@ type HttpClient = (url: string, init?: {
     method?: string;
     headers?: Record<string, string>;
     body?: string;
+    /**
+     * The answer is a file, such as an invoice's document: ask for its
+     * body as it arrived, which `HttpResponse.bytes` then hands over. A
+     * client that leaves this out still serves every other request.
+     */
+    binary?: boolean;
 }) => Promise<HttpResponse>;
 interface HttpResponse {
     status: number;
@@ -18,6 +24,11 @@ interface HttpResponse {
     };
     json(): Promise<unknown>;
     text(): Promise<string>;
+    /**
+     * The body as it arrived, for a request made with `binary`. Optional: only
+     * the downloads ask for it, and they say so where a client has none.
+     */
+    bytes?(): Promise<Uint8Array>;
 }
 /** Simple persistence adapter; default is `localStorage`. */
 interface KvStore {
@@ -386,6 +397,56 @@ declare const auditResource: ResourceDef<{
     readonly list: (http: HttpClient, ctx: ResourceContext, filter?: AuditListFilter) => Promise<AuditEntry[]>;
 }>;
 
+interface ResourceRequestInit {
+    /** Default `GET`. */
+    method?: string;
+    /** Serialised here — the `HttpClient` contract only carries strings. */
+    body?: unknown;
+    /** Merged over the defaults, so a caller's header wins. */
+    headers?: Record<string, string>;
+}
+/**
+ * Sends a request and returns the parsed body, or `null` when there was none.
+ *
+ * `null` covers both a `204` and a 2xx whose body would not parse. The two are
+ * deliberately not distinguished: every caller treats them the same way — a
+ * list turns `null` into `[]`, a mutation turns it into a failure — and no
+ * endpoint in this family answers a mutation with an empty 200 on purpose.
+ *
+ * A non-2xx throws an `AdminError` carrying the parsed body, so a caller can
+ * still branch on `status` and `body.code` the way the pages do today.
+ *
+ * A client that resolved without an HTTP status throws before any of that: no
+ * status means the request never reached the server, which is a transport
+ * failure and not an answer this function may read.
+ */
+declare function requestJson<T>(http: HttpClient, url: string, init?: ResourceRequestInit): Promise<T | null>;
+/** A file a download answered: its bytes, its media type and the name it is offered under. */
+interface DownloadedFile {
+    content: Uint8Array;
+    mediaType: string;
+    fileName: string;
+}
+/**
+ * Downloads the file `url` answers, such as an invoice's archived document. A
+ * refusal is thrown as `requestJson` throws it, from the JSON body the server
+ * answers a refusal with. The name is the one `Content-Disposition` offers, or
+ * `fallbackName` where it offers none.
+ *
+ * Needs a client whose responses have `bytes()`: both clients the package
+ * ships do. One of the application's own that has none is said, rather than
+ * read through `text()`, which would hand a PDF over decoded as UTF-8.
+ */
+declare function requestFile(http: HttpClient, url: string, fallbackName: string): Promise<DownloadedFile>;
+/**
+ * Reads the body of a request that must answer with one.
+ *
+ * The empty case is a failure rather than a `null` the caller has to re-check:
+ * a create that returns nothing has not told us what it created. Raised with
+ * `status: 0`, because no HTTP status went wrong — the response was a 2xx.
+ */
+declare function requestJsonBody<T>(http: HttpClient, url: string, what: string, init?: ResourceRequestInit): Promise<T>;
+
 /** 1-based: the page a list starts on, and the one a changed filter returns to. */
 declare const LIST_FIRST_PAGE = 1;
 /**
@@ -532,12 +593,48 @@ declare const tenantsResource: ResourceDef<{
      * `payments.read`.
      */
     readonly payments: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<AdminTenantPayments>;
+    /**
+     * The tenant's contracts, the newest first, each with where its
+     * confirmation stands. Served only where the manifest announces
+     * `contracts.read`.
+     */
+    readonly contracts: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<AdminTenantContracts>;
+    /**
+     * The archived confirmation of one contract, the file its subscriber was
+     * sent. Served where the manifest announces `contracts.read`.
+     */
+    readonly contractConfirmation: (http: HttpClient, ctx: ResourceContext, contractId: string) => Promise<DownloadedFile>;
+    /**
+     * The archived document of one invoice, the file it was issued as. Served
+     * where the manifest announces `invoices.read`.
+     */
+    readonly invoiceDocument: (http: HttpClient, ctx: ResourceContext, invoiceId: string) => Promise<DownloadedFile>;
     /**
      * Records a payout made outside the gateway against one credit, and
      * answers the credits as they stand after it. Requires the second factor;
      * served where the manifest announces `credits.payout`.
      */
     readonly recordPayout: (http: HttpClient, ctx: ResourceContext, slug: string, creditId: string, payout: AdminSubscriberPayout, mfaCode?: string) => Promise<AdminSubscriberCredits>;
+    /**
+     * One of the tenant's invoices with its lines, each with what its charge
+     * stands at and whether a cancellation may correct it. Served where the
+     * manifest announces `invoices.cancel`.
+     */
+    readonly invoice: (http: HttpClient, ctx: ResourceContext, slug: string, invoiceId: string) => Promise<AdminInvoice>;
+    /**
+     * What cancelling one of the tenant's invoices would write — the
+     * cancellation invoice, the replacement and where what was paid goes —,
+     * computed as the cancellation computes it and refused as it is; nothing
+     * is written. Served where the manifest announces `invoices.cancel`.
+     */
+    readonly previewInvoiceCancellation: (http: HttpClient, ctx: ResourceContext, slug: string, invoiceId: string, request: InvoiceCancellationRequest) => Promise<AdminInvoiceCancellationPlan>;
+    /**
+     * Cancels one of the tenant's invoices by a cancellation invoice and its
+     * replacement. Requires the second factor; the request carries the
+     * preview's digest, and a preview that no longer holds is refused with the
+     * new one.
+     */
+    readonly cancelInvoice: (http: HttpClient, ctx: ResourceContext, slug: string, invoiceId: string, request: InvoiceCancellationRequest, mfaCode?: string) => Promise<AdminCancelledInvoice>;
     /**
      * The tenant's subscriber, its tax details and what holds its next
      * contract back. Served only where the manifest announces
@@ -862,7 +959,13 @@ declare const platformResources: {
         readonly charges: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<_saasicat_core.AdminSubscriberAccount>;
         readonly credits: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<_saasicat_core.AdminSubscriberCredits>;
         readonly payments: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<_saasicat_core.AdminTenantPayments>;
+        readonly contracts: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<_saasicat_core.AdminTenantContracts>;
+        readonly contractConfirmation: (http: HttpClient, ctx: ResourceContext, contractId: string) => Promise<DownloadedFile>;
+        readonly invoiceDocument: (http: HttpClient, ctx: ResourceContext, invoiceId: string) => Promise<DownloadedFile>;
         readonly recordPayout: (http: HttpClient, ctx: ResourceContext, slug: string, creditId: string, payout: _saasicat_core.AdminSubscriberPayout, mfaCode?: string) => Promise<_saasicat_core.AdminSubscriberCredits>;
+        readonly invoice: (http: HttpClient, ctx: ResourceContext, slug: string, invoiceId: string) => Promise<_saasicat_core.AdminInvoice>;
+        readonly previewInvoiceCancellation: (http: HttpClient, ctx: ResourceContext, slug: string, invoiceId: string, request: _saasicat_core.InvoiceCancellationRequest) => Promise<_saasicat_core.AdminInvoiceCancellationPlan>;
+        readonly cancelInvoice: (http: HttpClient, ctx: ResourceContext, slug: string, invoiceId: string, request: _saasicat_core.InvoiceCancellationRequest, mfaCode?: string) => Promise<_saasicat_core.AdminCancelledInvoice>;
         readonly subscriber: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<_saasicat_core.AdminTenantSubscriber>;
         readonly subscriberHistory: (http: HttpClient, ctx: ResourceContext, slug: string) => Promise<_saasicat_core.AdminSubscriberHistoryEntry[]>;
         readonly correctSubscriberIdentity: (http: HttpClient, ctx: ResourceContext, slug: string, correction: SubscriberIdentityCorrectionInput, mfaCode?: string) => Promise<_saasicat_core.AdminSubscriberCorrected>;
@@ -1538,6 +1641,7 @@ declare const errorsMessages: Record<SaBuiltinLocale, {
     server: string;
     httpStatus: string;
     unexpected: string;
+    codes: Record<_saasicat_core.PlatformErrorCode, string>;
 }>;
 
 declare const featureWithdrawalsMessages: Record<SaBuiltinLocale, {
@@ -2767,6 +2871,7 @@ declare const tenantsMessages: Record<SaBuiltinLocale, {
         fromPayment: string;
         fromInvoice: string;
         fromReversal: string;
+        fromCancellation: string;
         unknownInvoice: string;
         payOut: string;
         mfaPayout: string;
@@ -2796,6 +2901,102 @@ declare const tenantsMessages: Record<SaBuiltinLocale, {
         columnOwed: string;
         casesTitle: string;
         casesEmpty: string;
+        columnStanding: string;
+        cancellationOf: string;
+        replacementOf: string;
+        cancelledBy: string;
+        cancel: string;
+        cancelInvoice: string;
+        download: string;
+        downloadInvoice: string;
+        mfaCancel: string;
+        cancelled: string;
+        cancelledWithoutReplacement: string;
+        cancelDialog: {
+            askSubtitle: string;
+            reason: string;
+            reasonHint: string;
+            lines: string;
+            linesCaption: string;
+            linesLoadFailed: string;
+            lineChoice: string;
+            lineOwed: string;
+            lineNotOwed: string;
+            linePart: string;
+            lineAmount: string;
+            lineAmountHint: string;
+            lineFollows: string;
+            lineCorrection: string;
+            lineNothing: string;
+            movedLines: string;
+            movedLine: string;
+            replacementLines: string;
+            deliverTo: string;
+            deliverToHint: string;
+            corrections: string;
+            correctionsCaption: string;
+            onRecord: string;
+            onRecordEmpty: string;
+            takeOver: string;
+            takeOverLabel: string;
+            cleared: string;
+            preview: string;
+            previewSubtitle: string;
+            cancellationInvoice: string;
+            replacement: string;
+            noReplacement: string;
+            amounts: string;
+            tax: string;
+            dates: string;
+            movedIn: string;
+            credited: string;
+            deliveredTo: string;
+            toRecord: string;
+            party: string;
+            changed: string;
+            none: string;
+            back: string;
+            submit: string;
+            previewChanged: string;
+            taxTreatment: {
+                standard: string;
+                reduced: string;
+                exempt: string;
+                'reverse-charge': string;
+                'not-taxable': string;
+                'small-business': string;
+            };
+        };
+    };
+    contracts: {
+        title: string;
+        subtitle: string;
+        loadFailed: string;
+        empty: string;
+        columnConcluded: string;
+        columnStart: string;
+        columnStatus: string;
+        columnBilling: string;
+        columnTotal: string;
+        columnTerms: string;
+        columnNotice: string;
+        columnConfirmation: string;
+        noTerms: string;
+        noticeDays: string;
+        statuses: {
+            active: string;
+            scheduled: string;
+            terminated: string;
+            superseded: string;
+        };
+        states: {
+            'not-due': string;
+            'being-made': string;
+            'awaiting-mail': string;
+            sent: string;
+        };
+        download: string;
+        downloadConfirmation: string;
     };
     subscriber: {
         title: string;
@@ -2865,6 +3066,7 @@ declare const tenantsMessages: Record<SaBuiltinLocale, {
         };
         field: {
             addressLine1: string;
+            addressLine2: string;
             postalCode: string;
             city: string;
             country: string;
@@ -3058,4 +3260,4 @@ interface SaCatalog {
  */
 declare function createSaCatalog(options?: SaCatalogOptions): SaCatalog;
 
-export { type ResourceOps as $, ActionDefNotInManifestError as A, type Bound as B, type PilotEditPayload as C, DEFAULT_SA_LOCALE as D, type EmailHistoryDetail as E, type FeatureWithdrawalAnnouncementInput as F, type PilotEditResult as G, type HttpClient as H, type PilotRow as I, type PlatformEmailProvider as J, type KpiReading as K, LIST_FIRST_PAGE as L, type MaintenanceAnnouncementInput as M, type PlatformEmailTestInput as N, type PlatformEmailTestResult as O, type PartialMessages as P, type PlatformEmailWriteInput as Q, type PlatformResources as R, type PromoCodesFilter as S, type PromoDetail as T, type PublishBundleVersionOptions as U, type PublishPlanVersionOptions as V, type ResolvedAction as W, type ResourceContext as X, type ResourceDef as Y, type ResourceListPage as Z, type ResourceOp as _, type ActionHandler as a, type RetirementAnnouncement as a0, SA_INTL_LOCALES as a1, SA_LOCALES as a2, SA_LOCALE_LABELS as a3, SA_MESSAGES as a4, type SaBuiltinLocale as a5, type SaCatalog as a6, type SaCatalogOptions as a7, type SaLocale as a8, type SaLocaleDefinition as a9, isMaintenanceOverview as aA, isSaBuiltinLocale as aB, isSentInQuery as aC, listUrl as aD, maintenanceResource as aE, marketingResource as aF, mergeMessages as aG, planVersionsResource as aH, plansResource as aI, platformResources as aJ, promoCodesResource as aK, readListPage as aL, resolveMessages as aM, settingsResource as aN, tenantsResource as aO, versionRetirementsResource as aP, type SaNavMessages as aQ, type SaLocaleOption as aa, type SaMessages as ab, type SaMessagesOverrides as ac, type SettingsChangeView as ad, type SettingsDifferenceView as ae, type SubscriberBusinessStatusInput as af, type SubscriberIdentityCorrectionInput as ag, type TenantsListFilter as ah, type TranslationOf as ai, auditResource as aj, bindResource as ak, bundleVersionRetirementsResource as al, bundleVersionsResource as am, bundlesResource as an, clampListPage as ao, clampListPageSize as ap, createSaCatalog as aq, dashboardResource as ar, defaultHttpClient as as, defaultKvStore as at, defineListOp as au, defineMessages as av, defineResource as aw, discoveryResource as ax, featureWithdrawalsResource as ay, filterQueryString as az, ActionRegistry as b, type AppliedSettingsView as c, type AuditListFilter as d, type BundleRetirementAnnouncement as e, type DiscoveryRead as f, type EmailHistoryFilter as g, type EmailHistoryListResult as h, type EmailHistoryResendResult as i, type EmailHistoryRow as j, type EmailHistoryStatus as k, type HttpResponse as l, type KvStore as m, LIST_PAGE_SIZE_DEFAULT as n, LIST_PAGE_SIZE_MAX as o, LIST_PAGINATION_PARAMS as p, type ListFilterOf as q, type ListOp as r, type ListQuery as s, type MaintenanceLockInput as t, type MaintenanceRevisionInput as u, type MarketingProjectionsFilter as v, type MessageTree as w, MissingHandlerError as x, type PilotCreatePayload as y, type PilotCreateResult as z };
+export { type ResourceOp as $, ActionDefNotInManifestError as A, type Bound as B, type PilotCreateResult as C, DEFAULT_SA_LOCALE as D, type EmailHistoryDetail as E, type FeatureWithdrawalAnnouncementInput as F, type PilotEditPayload as G, type HttpClient as H, type PilotEditResult as I, type PilotRow as J, type KpiReading as K, LIST_FIRST_PAGE as L, type MaintenanceAnnouncementInput as M, type PlatformEmailProvider as N, type PlatformEmailTestInput as O, type PartialMessages as P, type PlatformEmailTestResult as Q, type PlatformEmailWriteInput as R, type PlatformResources as S, type PromoCodesFilter as T, type PromoDetail as U, type PublishBundleVersionOptions as V, type PublishPlanVersionOptions as W, type ResolvedAction as X, type ResourceContext as Y, type ResourceDef as Z, type ResourceListPage as _, type ActionHandler as a, type ResourceOps as a0, type ResourceRequestInit as a1, type RetirementAnnouncement as a2, SA_INTL_LOCALES as a3, SA_LOCALES as a4, SA_LOCALE_LABELS as a5, SA_MESSAGES as a6, type SaBuiltinLocale as a7, type SaCatalog as a8, type SaCatalogOptions as a9, featureWithdrawalsResource as aA, filterQueryString as aB, isMaintenanceOverview as aC, isSaBuiltinLocale as aD, isSentInQuery as aE, listUrl as aF, maintenanceResource as aG, marketingResource as aH, mergeMessages as aI, planVersionsResource as aJ, plansResource as aK, platformResources as aL, promoCodesResource as aM, readListPage as aN, requestFile as aO, requestJson as aP, requestJsonBody as aQ, resolveMessages as aR, settingsResource as aS, tenantsResource as aT, versionRetirementsResource as aU, type SaNavMessages as aV, type SaLocale as aa, type SaLocaleDefinition as ab, type SaLocaleOption as ac, type SaMessages as ad, type SaMessagesOverrides as ae, type SettingsChangeView as af, type SettingsDifferenceView as ag, type SubscriberBusinessStatusInput as ah, type SubscriberIdentityCorrectionInput as ai, type TenantsListFilter as aj, type TranslationOf as ak, auditResource as al, bindResource as am, bundleVersionRetirementsResource as an, bundleVersionsResource as ao, bundlesResource as ap, clampListPage as aq, clampListPageSize as ar, createSaCatalog as as, dashboardResource as at, defaultHttpClient as au, defaultKvStore as av, defineListOp as aw, defineMessages as ax, defineResource as ay, discoveryResource as az, ActionRegistry as b, type AppliedSettingsView as c, type AuditListFilter as d, type BundleRetirementAnnouncement as e, type DiscoveryRead as f, type DownloadedFile as g, type EmailHistoryFilter as h, type EmailHistoryListResult as i, type EmailHistoryResendResult as j, type EmailHistoryRow as k, type EmailHistoryStatus as l, type HttpResponse as m, type KvStore as n, LIST_PAGE_SIZE_DEFAULT as o, LIST_PAGE_SIZE_MAX as p, LIST_PAGINATION_PARAMS as q, type ListFilterOf as r, type ListOp as s, type ListQuery as t, type MaintenanceLockInput as u, type MaintenanceRevisionInput as v, type MarketingProjectionsFilter as w, type MessageTree as x, MissingHandlerError as y, type PilotCreatePayload as z };

package/dist/{chunk-OAY5OVAZ.js → chunk-C6IYEQYN.js}

@@ -4,7 +4,7 @@ import {
   bindResource,
   createSaCatalog,
   defaultKvStore
-} from "./chunk-XNFQOQ4E.js";
+} from "./chunk-RDLOR3OP.js";
 
 // src/vue/super-admin-context.ts
 var SUPER_ADMIN_BRAND_KEY = /* @__PURE__ */ Symbol.for(