@managemint-solutions/sdk 0.40.1 → 0.41.0

package/dist/billing/index.d.ts

@@ -19,6 +19,8 @@ export declare class BillingReadsResource {
     openTransaction(openStatuses: string[]): Promise<BillingTransactionRow | null>;
     /** The replay lookup: the same key must never raise a second charge. */
     transactionByIdempotencyKey(idempotencyKey: string): Promise<BillingTransactionRow | null>;
+    /** The organization's newest renewal in this status, or null. */
+    latestRenewalIn(transactionStatus: string): Promise<BillingTransactionRow | null>;
     /**
      * The organization's payments, newest first: every ledger row, whatever its type or
      * status. RLS scopes the rows; the eq is belt-and-braces.

package/dist/billing/index.js

@@ -26,7 +26,7 @@ const BILLING_TRANSACTIONS_TABLE = {
     entityType: enum_1.AuditTrailEntityType.BILLING_TRANSACTIONS,
 };
 /** The wire shape of a payment list row - never the internal bigint id, never the checkout secrets. */
-const PAYMENT_SUMMARY_SELECT = 'mms_id, created_at, transaction_type, transaction_status, amount_minor, currency, paid_at, failure_reason';
+const PAYMENT_SUMMARY_SELECT = 'mms_id, created_at, transaction_type, transaction_status, amount_minor, currency, paid_at, failure_reason, refunded_at, refund_amount_minor';
 /**
  * PaymentEntity, column for column, plus the renewal's invoice through the unique
  * `invoices.billing_transaction_id` foreign key. The Paystack access code and
@@ -70,6 +70,21 @@ class BillingReadsResource {
             throw (0, errors_1.mapPostgrestError)(error);
         return data ? (0, audit_1.withoutInternalId)(data) : null;
     }
+    /** The organization's newest renewal in this status, or null. */
+    async latestRenewalIn(transactionStatus) {
+        const { data, error } = await this.supabase
+            .from('billing_transactions')
+            .select('*')
+            .eq('organization_id', this.actor.organization_id)
+            .eq('transaction_type', enum_2.BillingTransactionType.RENEWAL)
+            .eq('transaction_status', transactionStatus)
+            .order('created_at', { ascending: false })
+            .limit(1)
+            .maybeSingle();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return data ? (0, audit_1.withoutInternalId)(data) : null;
+    }
     /**
      * The organization's payments, newest first: every ledger row, whatever its type or
      * status. RLS scopes the rows; the eq is belt-and-braces.

package/dist/billing/invoices/index.d.ts

@@ -21,14 +21,26 @@ export declare class InvoicesReadsResource {
 /**
  * The document writes, on the service client only - every write policy on `invoices` is
  * `false` for `authenticated`. Rows are written by the api's billing service beside a
- * renewal's ledger write - a renewal is inserted already paid, so an invoice never moves
- * status after it is issued - never by a caller.
+ * renewal's ledger row, never by a caller; an invoice mirrors its ledger row's status.
  */
 export declare class InvoicesResource extends InvoicesReadsResource {
     private readonly invoices;
     constructor(supabase: TypedSupabaseClient, actor: AuditActor, audit: AuditResource);
     /** Audited insert of the accounting document beside its ledger row. */
     create(payload: AuditRow): Promise<AuditRow>;
+    /** Audited status change: the row follows its ledger row (paid, refunded). */
+    update(invoiceId: string, patch: AuditRow): Promise<AuditRow>;
+    /**
+     * The invoice Paystack named with this INV_… code, or null. The invoice events
+     * (create, payment_failed, update) all carry the code, so it is how a later event finds
+     * the row an earlier one opened.
+     */
+    byPaystackInvoiceCode(invoiceCode: string): Promise<InvoiceEntity | null>;
+    /**
+     * The invoice behind a ledger row, or null. `billing_transaction_id` is unique, so a
+     * renewal has at most one; every other transaction type has none.
+     */
+    byTransactionId(transactionId: string): Promise<InvoiceEntity | null>;
     /**
      * The organization's highest invoice number, 0 when it has none. The api assigns
      * `max + 1` and lets the `(organization_id, invoice_number)` unique index arbitrate a

package/dist/billing/invoices/index.js

@@ -27,7 +27,7 @@ const INVOICES_TABLE = {
 /** The wire shape of an invoice list row - never the internal bigint id. */
 const INVOICE_SUMMARY_SELECT = 'mms_id, invoice_number, transaction_type, status, issued_at, paid_at, amount_minor, currency';
 /** InvoiceEntity, column for column: the summary plus the frozen document data. */
-const INVOICE_ENTITY_SELECT = `${INVOICE_SUMMARY_SELECT}, billing_transaction_id, paystack_reference, period_start, period_end, line_items, billed_to`;
+const INVOICE_ENTITY_SELECT = `${INVOICE_SUMMARY_SELECT}, billing_transaction_id, paystack_reference, paystack_invoice_code, period_start, period_end, line_items, billed_to`;
 /**
  * The readable half. `invoices` is SELECT-only for `authenticated` with an org-predicate
  * policy - the same posture as the ledger it mirrors - so reads run on the caller's own
@@ -78,8 +78,7 @@ exports.InvoicesReadsResource = InvoicesReadsResource;
 /**
  * The document writes, on the service client only - every write policy on `invoices` is
  * `false` for `authenticated`. Rows are written by the api's billing service beside a
- * renewal's ledger write - a renewal is inserted already paid, so an invoice never moves
- * status after it is issued - never by a caller.
+ * renewal's ledger row, never by a caller; an invoice mirrors its ledger row's status.
  */
 class InvoicesResource extends InvoicesReadsResource {
     invoices;
@@ -91,6 +90,44 @@ class InvoicesResource extends InvoicesReadsResource {
     async create(payload) {
         return this.invoices.insert(payload);
     }
+    /** Audited status change: the row follows its ledger row (paid, refunded). */
+    async update(invoiceId, patch) {
+        return this.invoices.update(invoiceId, {
+            ...patch,
+            updated_at: new Date().toISOString(),
+        });
+    }
+    /**
+     * The invoice Paystack named with this INV_… code, or null. The invoice events
+     * (create, payment_failed, update) all carry the code, so it is how a later event finds
+     * the row an earlier one opened.
+     */
+    async byPaystackInvoiceCode(invoiceCode) {
+        const { data, error } = await this.supabase
+            .from('invoices')
+            .select(INVOICE_ENTITY_SELECT)
+            .eq('paystack_invoice_code', invoiceCode)
+            .eq('organization_id', this.actor.organization_id)
+            .maybeSingle();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return data ?? null;
+    }
+    /**
+     * The invoice behind a ledger row, or null. `billing_transaction_id` is unique, so a
+     * renewal has at most one; every other transaction type has none.
+     */
+    async byTransactionId(transactionId) {
+        const { data, error } = await this.supabase
+            .from('invoices')
+            .select(INVOICE_ENTITY_SELECT)
+            .eq('billing_transaction_id', transactionId)
+            .eq('organization_id', this.actor.organization_id)
+            .maybeSingle();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return data ?? null;
+    }
     /**
      * The organization's highest invoice number, 0 when it has none. The api assigns
      * `max + 1` and lets the `(organization_id, invoice_number)` unique index arbitrate a

package/dist/service-client/index.d.ts

@@ -103,5 +103,12 @@ export declare class SupabaseServiceClient {
      * transaction id in its metadata, and the row is what says which tenant it belongs to.
      */
     findTransaction(transactionId: string): Promise<Record<string, unknown> | null>;
+    /**
+     * A ledger row by its Paystack reference. Unscoped for the same reason as
+     * `findTransaction`: a refund event names only `transaction_reference`, and the row is
+     * what says which tenant it belongs to. The partial unique index on
+     * `paystack_reference` makes at most one row match.
+     */
+    findTransactionByReference(reference: string): Promise<Record<string, unknown> | null>;
 }
 export declare const createSupabaseServiceClient: (config: SupabaseServiceClientConfig) => SupabaseServiceClient;

package/dist/service-client/index.js

@@ -182,6 +182,22 @@ class SupabaseServiceClient {
             throw (0, errors_1.mapPostgrestError)(error);
         return data ? (0, audit_1.withoutInternalId)(data) : null;
     }
+    /**
+     * A ledger row by its Paystack reference. Unscoped for the same reason as
+     * `findTransaction`: a refund event names only `transaction_reference`, and the row is
+     * what says which tenant it belongs to. The partial unique index on
+     * `paystack_reference` makes at most one row match.
+     */
+    async findTransactionByReference(reference) {
+        const { data, error } = await this.supabase
+            .from('billing_transactions')
+            .select('*')
+            .eq('paystack_reference', reference)
+            .maybeSingle();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return data ? (0, audit_1.withoutInternalId)(data) : null;
+    }
 }
 exports.SupabaseServiceClient = SupabaseServiceClient;
 const createSupabaseServiceClient = (config) => new SupabaseServiceClient(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@managemint-solutions/sdk",
-  "version": "0.40.1",
+  "version": "0.41.0",
   "description": "Typed Supabase data-access SDK for ManageMint Solutions",
   "license": "UNLICENSED",
   "author": "Scott Bebington <scottbebington@gmail.com>",
@@ -51,7 +51,7 @@
     "testEnvironment": "node"
   },
   "dependencies": {
-    "@managemint-solutions/entities": "^1.23.1"
+    "@managemint-solutions/entities": "^1.24.0"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",