@spytecgps/nova-orm 1.4.299 → 1.4.300

package/dist/entities/referralCredit.d.ts

@@ -14,7 +14,7 @@ export type ReferralCreditType = (typeof typeArray)[number];
  *   total earned      = SUM(amountCents) WHERE type = 'earned'
  *   credit applied    = -SUM(amountCents) WHERE type = 'applied'
  * A negative overall balance is meaningful — it is a clawback of credit that an invoice had already
- * consumed, and is settled by pushing a positive (debit) transaction back to the provider.
+ * consumed, and is settled by pushing a positive (debit) transaction to Stripe.
  */
 export declare class ReferralCredit {
     id: number;
@@ -30,9 +30,18 @@ export declare class ReferralCredit {
     /** `issuedAt + 12 months`. Set on `earned` rows only. */
     expiresAt: Date | null;
     /**
-     * The provider's own reference for this movement, and the reason a retried drip cannot double-apply
-     * — it is uniquely indexed. A Stripe customer balance transaction id on the Stripe path (including
-     * the debit id when a clawback is settled), or the discount id Loop returns on the Loop path.
+     * @deprecated Superseded by `externalCreditRef`. Dropped in a follow-up schema deploy.
+     *
+     * PlanetScale does not support column renames, so the two columns coexist for one release: this
+     * one is no longer written, and nothing needs copying because the table is empty. Remove this
+     * property once `externalCreditRef` has deployed.
+     */
+    stripeBalanceTxId: string | null;
+    /**
+     * The provider's own reference for this movement, and the reason a retried drip cannot
+     * double-apply — it is uniquely indexed. A Stripe customer balance transaction id on the Stripe
+     * path, including the debit id when a clawback is settled; the discount id Loop returns on the
+     * Loop path.
      *
      * Deliberately not named for Stripe: the referrer's platform decides which sink is used, and a
      * Loop-billed referrer is paid with a subscription discount rather than a balance transaction.

package/dist/entities/referralCredit.js

@@ -1 +1 @@
-"use strict";var e=require("../node_modules/tslib/tslib.es6.js"),t=require("typeorm");exports.ReferralCredit=class ReferralCredit{id;referralId;clientId;customerId;type;amountCents;issuedAt;expiresAt;externalCreditRef;appliedInvoiceId;appliedAt;adjustedByUsername;note;createdAt;updatedAt},e.__decorate([t.PrimaryGeneratedColumn({type:"int",name:"id"}),e.__metadata("design:type",Number)],exports.ReferralCredit.prototype,"id",void 0),e.__decorate([t.Column("int",{name:"referralId",nullable:!0}),e.__metadata("design:type",Number)],exports.ReferralCredit.prototype,"referralId",void 0),e.__decorate([t.Column("int",{name:"clientId"}),e.__metadata("design:type",Number)],exports.ReferralCredit.prototype,"clientId",void 0),e.__decorate([t.Column("varchar",{name:"customerId",nullable:!0,length:50}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"customerId",void 0),e.__decorate([t.Column("enum",{enum:["earned","applied","expired","clawback","manual_adjustment"],name:"type"}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"type",void 0),e.__decorate([t.Column("int",{name:"amountCents"}),e.__metadata("design:type",Number)],exports.ReferralCredit.prototype,"amountCents",void 0),e.__decorate([t.Column("datetime",{name:"issuedAt"}),e.__metadata("design:type",Date)],exports.ReferralCredit.prototype,"issuedAt",void 0),e.__decorate([t.Column("datetime",{name:"expiresAt",nullable:!0}),e.__metadata("design:type",Date)],exports.ReferralCredit.prototype,"expiresAt",void 0),e.__decorate([t.Column("varchar",{name:"externalCreditRef",nullable:!0,length:100}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"externalCreditRef",void 0),e.__decorate([t.Column("varchar",{name:"appliedInvoiceId",nullable:!0,length:100}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"appliedInvoiceId",void 0),e.__decorate([t.Column("datetime",{name:"appliedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.ReferralCredit.prototype,"appliedAt",void 0),e.__decorate([t.Column("varchar",{name:"adjustedByUsername",nullable:!0,length:255}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"adjustedByUsername",void 0),e.__decorate([t.Column("varchar",{name:"note",nullable:!0,length:500}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"note",void 0),e.__decorate([t.Column("datetime",{name:"createdAt",nullable:!0}),e.__metadata("design:type",Date)],exports.ReferralCredit.prototype,"createdAt",void 0),e.__decorate([t.Column("datetime",{name:"updatedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.ReferralCredit.prototype,"updatedAt",void 0),exports.ReferralCredit=e.__decorate([t.Index("ixuReferralCreditExternalRef",["externalCreditRef"],{unique:!0}),t.Index("ixReferralCreditClientType",["clientId","type"],{}),t.Index("ixReferralCreditReferral",["referralId"],{}),t.Index("ixReferralCreditExpiresAt",["expiresAt"],{}),t.Index("ixReferralCreditClientIssuedAt",["clientId","issuedAt"],{}),t.Entity("referralCredit",{schema:"nova"})],exports.ReferralCredit);
+"use strict";var e=require("../node_modules/tslib/tslib.es6.js"),t=require("typeorm");exports.ReferralCredit=class ReferralCredit{id;referralId;clientId;customerId;type;amountCents;issuedAt;expiresAt;stripeBalanceTxId;externalCreditRef;appliedInvoiceId;appliedAt;adjustedByUsername;note;createdAt;updatedAt},e.__decorate([t.PrimaryGeneratedColumn({type:"int",name:"id"}),e.__metadata("design:type",Number)],exports.ReferralCredit.prototype,"id",void 0),e.__decorate([t.Column("int",{name:"referralId",nullable:!0}),e.__metadata("design:type",Number)],exports.ReferralCredit.prototype,"referralId",void 0),e.__decorate([t.Column("int",{name:"clientId"}),e.__metadata("design:type",Number)],exports.ReferralCredit.prototype,"clientId",void 0),e.__decorate([t.Column("varchar",{name:"customerId",nullable:!0,length:50}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"customerId",void 0),e.__decorate([t.Column("enum",{enum:["earned","applied","expired","clawback","manual_adjustment"],name:"type"}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"type",void 0),e.__decorate([t.Column("int",{name:"amountCents"}),e.__metadata("design:type",Number)],exports.ReferralCredit.prototype,"amountCents",void 0),e.__decorate([t.Column("datetime",{name:"issuedAt"}),e.__metadata("design:type",Date)],exports.ReferralCredit.prototype,"issuedAt",void 0),e.__decorate([t.Column("datetime",{name:"expiresAt",nullable:!0}),e.__metadata("design:type",Date)],exports.ReferralCredit.prototype,"expiresAt",void 0),e.__decorate([t.Column("varchar",{name:"stripeBalanceTxId",nullable:!0,length:100}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"stripeBalanceTxId",void 0),e.__decorate([t.Column("varchar",{name:"externalCreditRef",nullable:!0,length:100}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"externalCreditRef",void 0),e.__decorate([t.Column("varchar",{name:"appliedInvoiceId",nullable:!0,length:100}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"appliedInvoiceId",void 0),e.__decorate([t.Column("datetime",{name:"appliedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.ReferralCredit.prototype,"appliedAt",void 0),e.__decorate([t.Column("varchar",{name:"adjustedByUsername",nullable:!0,length:255}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"adjustedByUsername",void 0),e.__decorate([t.Column("varchar",{name:"note",nullable:!0,length:500}),e.__metadata("design:type",String)],exports.ReferralCredit.prototype,"note",void 0),e.__decorate([t.Column("datetime",{name:"createdAt",nullable:!0}),e.__metadata("design:type",Date)],exports.ReferralCredit.prototype,"createdAt",void 0),e.__decorate([t.Column("datetime",{name:"updatedAt",nullable:!0}),e.__metadata("design:type",Date)],exports.ReferralCredit.prototype,"updatedAt",void 0),exports.ReferralCredit=e.__decorate([t.Index("ixuReferralCreditStripeTx",["stripeBalanceTxId"],{unique:!0}),t.Index("ixuReferralCreditExternalRef",["externalCreditRef"],{unique:!0}),t.Index("ixReferralCreditClientType",["clientId","type"],{}),t.Index("ixReferralCreditReferral",["referralId"],{}),t.Index("ixReferralCreditExpiresAt",["expiresAt"],{}),t.Index("ixReferralCreditClientIssuedAt",["clientId","issuedAt"],{}),t.Entity("referralCredit",{schema:"nova"})],exports.ReferralCredit);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spytecgps/nova-orm",
-  "version": "1.4.299",
+  "version": "1.4.300",
   "description": "ORM with PlanetScale",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/schema.sql

@@ -1,6 +1,6 @@
--- nova-orm-schema-checksum: 48040cde7e40b0592f8ff8625e47b68c
+-- nova-orm-schema-checksum: c975efa248fad5e33398cdadc89287b8
 -- Nova ORM Schema Dump
--- Generated at: 2026-09-02T22:47:03.965Z
+-- Generated at: 2026-09-02T23:17:24.498Z
 
 SET FOREIGN_KEY_CHECKS = 0;
 
@@ -2941,6 +2941,7 @@ CREATE TABLE `referralCredit` (
   `amountCents` int NOT NULL,
   `issuedAt` datetime NOT NULL,
   `expiresAt` datetime DEFAULT NULL,
+  `stripeBalanceTxId` varchar(100) DEFAULT NULL,
   `externalCreditRef` varchar(100) DEFAULT NULL,
   `appliedInvoiceId` varchar(100) DEFAULT NULL,
   `appliedAt` datetime DEFAULT NULL,
@@ -2950,6 +2951,7 @@ CREATE TABLE `referralCredit` (
   `updatedAt` datetime DEFAULT NULL,
   PRIMARY KEY (`id`),
   UNIQUE KEY `ixuReferralCreditExternalRef` (`externalCreditRef`),
+  UNIQUE KEY `ixuReferralCreditStripeTx` (`stripeBalanceTxId`),
   KEY `ixReferralCreditClientIssuedAt` (`clientId`,`issuedAt`),
   KEY `ixReferralCreditExpiresAt` (`expiresAt`),
   KEY `ixReferralCreditReferral` (`referralId`),