merchi_sdk_ts 1.34.0 → 1.35.1

package/RELEASING.md

@@ -0,0 +1,43 @@
+# Automatic npm releases
+
+Merging to `main` triggers `.github/workflows/publish.yml`. No manually edited version or local `npm publish` is needed after the one-time npm trust setup.
+
+## One-time setup
+
+In npm package **merchi_sdk_ts** settings, add a GitHub Actions trusted publisher:
+
+- Owner: `merchisdk`
+- Repository: `merchi_sdk_ts`
+- Workflow filename: `publish.yml`
+- Environment: leave blank (the job has no GitHub environment)
+- Allow direct publishing (`npm publish`), not stage-only publishing.
+
+An npm package owner must authorize this once. There is no `NPM_TOKEN` dependency. Current local npm credentials returned 401, so this trust setup has not been verified or completed by Codex. GitHub branch rules must allow the workflow bot to write the version commit to `main`; the workflow never disables protection or force-pushes.
+
+Official setup: https://docs.npmjs.com/trusted-publishers/
+
+## Behavior
+
+- Builds latest `main` after acquiring a per-repository concurrency slot. Several rapid merges may be included in one release.
+- Uses an explicitly prepared stable version if it is newer than npm latest; otherwise automatically increments the registry's patch version. Major/minor releases remain deliberate changes to package.json.
+- Installs dependencies and builds before publishing. npm install also repairs the historical lockfile/manifest mismatch; the resulting lockfile and version are committed together.
+- Pushes the version commit with `[skip ci]` using `GITHUB_TOKEN`; it does not trigger another push workflow. A concurrent main update rejects the push and prevents publication of that attempt.
+- Publishes through npm OIDC, verifies registry version and git commit, then tags `v<version>`.
+- Re-runs of the already published commit do not bump or republish. If publication failed after the version commit, retries reuse the unpublished version only while it remains newer than latest and unoccupied.
+- The hourly run recovers interrupted releases and packages whose new dependencies were not published yet. A failed build or missing authorization still reports failure; it cannot be solved by inventing credentials or publishing broken code. A manual Actions rerun is optional.
+
+Merge/release SDK and invoice before cart and checkout for the initial wallet release. Cart/checkout require invoice 1.3.2 or later; if merged sooner they wait through failed install/retry runs until it exists. Consumers such as Dashboard retain their normal lockfile update/review process; this workflow does not merge or deploy consumers.
+
+Validation: local release planner tests and YAML parsing. Package builds and payment regression tests were verified separately. Actual GitHub-to-npm publishing still requires the one-time trusted publisher setup and a merged workflow.
+
+## Coexistence with manual publishing
+
+Manual npm publishing remains allowed. The planner reads both latest and all occupied versions, skips occupied versions, and recognizes a manually published main commit even when its version differs from package.json. If latest has no gitHead or its commit is not an ancestor of main, automation pauses with a warning; merge the released source into main or investigate the package provenance before continuing. It never assumes unknown manual code is safe to replace.
+
+Immediately before publishing, the workflow rechecks latest and version availability. A changed registry or a concurrent same-version manual publication is deferred with a warning, without replacing that version or its Git tag. Network/auth/build failures remain failures; the next scheduled run retries. A successful publish with a lost response is reconciled against the registry gitHead.
+
+GitHub concurrency serializes Actions only, not developers' npm commands. npm has no cross-publisher lock or atomic compare-and-set for latest: simultaneous different-version manual and automatic publishes can still race on latest. When doing an exceptional manual release, coordinate to avoid an active publish job (or temporarily disable this workflow and wait for any active job to finish). Prefer the automatic workflow for routine releases. No script force-pushes, unpublishes, or rewrites an existing Git tag. Published version immutability prevents overwriting that version, but does not make latest race-free. First hosted OIDC publication still needs verification after merge.
+
+## Release recovery
+
+Publication verification queries the exact version with fresh registry reads, retrying up to seven times over 30 seconds without repeating npm publish. Each run also recovers the latest published version's missing Git tag before preparing a new release, including when main has advanced. Recovery requires the registry gitHead to be contained in the checkout history. Existing conflicting tags fail visibly and are never overwritten. Ignored, untracked lockfiles are not staged. Branch rules must still permit the normal version commit push; protection is never changed by this workflow.

package/dist/entities/cart.js

@@ -76,6 +76,10 @@ var Cart = /** @class */ (function (_super) {
         Cart.property(),
         __metadata("design:type", Number)
     ], Cart.prototype, "id", void 0);
+    __decorate([
+        Cart.property(),
+        __metadata("design:type", String)
+    ], Cart.prototype, "stripePaymentEngine", void 0);
     __decorate([
         Cart.property(),
         __metadata("design:type", Date)

package/dist/entities/cart.test.js

@@ -43,3 +43,9 @@ test('pass cookie tokens to query string', function () {
     expect(fetch.mock.calls[0][1]['query']).toEqual(correct);
     return invocation;
 });
+test('preserves server payment engine hint', function () {
+    var merchi = new Merchi();
+    var entity = new merchi.Cart();
+    entity.fromJson({ id: 1, stripePaymentEngine: 'wallet' });
+    expect(entity.toJson()).toMatchObject({ stripePaymentEngine: 'wallet' });
+});

package/dist/entities/domain.js

@@ -202,6 +202,9 @@ var Domain = /** @class */ (function (_super) {
         _this.updateStorefrontV2RepositoryFile = function (payload) {
             return _this.storefrontV2Request(_this.storefrontV2DomainResource('repository_file/'), 'POST', payload);
         };
+        _this.getStorefrontV2ProductStatus = function (productId) {
+            return _this.storefrontV2Request(_this.storefrontV2DomainResource("products/".concat(String(productId), "/status/")), 'GET');
+        };
         _this.publishStorefrontV2Product = function (payload) {
             return _this.storefrontV2Request(_this.storefrontV2DomainResource('products/publish/'), 'POST', payload);
         };

package/dist/entities/domain.test.js

@@ -249,6 +249,14 @@ test('can publish storefront v2 product', function () {
         productName: 'Wristband',
     });
 });
+test('can get storefront v2 product status', function () {
+    var merchi = new Merchi();
+    var domain = new merchi.Domain();
+    domain.id = 42;
+    var fetch = mockFetch(true, {}, 200);
+    domain.getStorefrontV2ProductStatus(88);
+    expect(fetch.mock.calls[0][0]).toContain('/domains/42/storefront_v2/products/88/status/');
+});
 test('can get storefront v2 change request by id', function () {
     var merchi = new Merchi();
     var domain = new merchi.Domain();

package/dist/entities/invoice.js

@@ -47,6 +47,10 @@ var Invoice = /** @class */ (function (_super) {
         Invoice.property(),
         __metadata("design:type", Number)
     ], Invoice.prototype, "id", void 0);
+    __decorate([
+        Invoice.property(),
+        __metadata("design:type", String)
+    ], Invoice.prototype, "stripePaymentEngine", void 0);
     __decorate([
         Invoice.property({ type: Date }),
         __metadata("design:type", Object)

package/dist/entities/invoice.test.js

@@ -37,3 +37,9 @@ test('client and invoice tokens supported by merchi', function () {
     expect(fetch.mock.calls[0][1]['query']).toEqual(correct);
     return invocation;
 });
+test('preserves server payment engine hint', function () {
+    var merchi = new Merchi();
+    var entity = new merchi.Invoice();
+    entity.fromJson({ id: 1, stripePaymentEngine: 'wallet' });
+    expect(entity.toJson()).toMatchObject({ stripePaymentEngine: 'wallet' });
+});

package/dist/entities/payment.js

@@ -61,6 +61,22 @@ var Payment = /** @class */ (function (_super) {
         Payment.property(),
         __metadata("design:type", Number)
     ], Payment.prototype, "paymentType", void 0);
+    __decorate([
+        Payment.property(),
+        __metadata("design:type", String)
+    ], Payment.prototype, "paymentProvider", void 0);
+    __decorate([
+        Payment.property(),
+        __metadata("design:type", String)
+    ], Payment.prototype, "paymentMethod", void 0);
+    __decorate([
+        Payment.property(),
+        __metadata("design:type", Number)
+    ], Payment.prototype, "refundedAmount", void 0);
+    __decorate([
+        Payment.property({ type: String }),
+        __metadata("design:type", Object)
+    ], Payment.prototype, "refundStatus", void 0);
     __decorate([
         Payment.property(),
         __metadata("design:type", String)

package/dist/entities/payment.test.js

@@ -14,3 +14,9 @@ test('payment refund', function () {
         expect(payment.amount).toEqual(10);
     });
 });
+test('wallet method and partial refund survive API serialization', function () {
+    var payment = new (new Merchi()).Payment();
+    payment.fromJson({ id: 8, amount: 20, paymentType: 1, paymentProvider: 'stripe',
+        paymentMethod: 'wechat_pay', refundedAmount: 5, refundStatus: 'pending' });
+    expect(payment.toJson()).toMatchObject({ paymentMethod: 'wechat_pay', refundedAmount: 5, refundStatus: 'pending' });
+});

package/dist/entities/product.js

@@ -194,6 +194,10 @@ var Product = /** @class */ (function (_super) {
         Product.property({ type: Date }),
         __metadata("design:type", Date)
     ], Product.prototype, "updated", void 0);
+    __decorate([
+        Product.property({ type: Date }),
+        __metadata("design:type", Object)
+    ], Product.prototype, "storefrontLastDeployed", void 0);
     __decorate([
         Product.property({ type: 'User' }),
         __metadata("design:type", Object)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "merchi_sdk_ts",
-  "version": "1.34.0",
+  "version": "1.35.1",
   "main": "dist/index.js",
   "type": "module",
   "repository": "git@github.com:merchisdk/merchi_sdk_ts.git",

package/src/entities/cart.test.ts

@@ -48,3 +48,10 @@ test('pass cookie tokens to query string', () => {
   expect(fetch.mock.calls[0][1]['query']).toEqual(correct);
   return invocation;
 });
+
+test('preserves server payment engine hint', () => {
+  const merchi = new Merchi();
+  const entity = new merchi.Cart();
+  entity.fromJson({ id: 1, stripePaymentEngine: 'wallet' });
+  expect(entity.toJson()).toMatchObject({ stripePaymentEngine: 'wallet' });
+});

package/src/entities/cart.ts

@@ -19,6 +19,9 @@ export class Cart extends Entity {
   @Cart.property()
   public id?: number;
 
+  @Cart.property()
+  public stripePaymentEngine?: string;
+
   @Cart.property()
   public creationDate?: Date;
 

package/src/entities/domain.test.ts

@@ -276,6 +276,17 @@ test('can publish storefront v2 product', () => {
   });
 });
 
+test('can get storefront v2 product status', () => {
+  const merchi = new Merchi();
+  const domain = new merchi.Domain();
+  domain.id = 42;
+  const fetch = mockFetch(true, {}, 200);
+  domain.getStorefrontV2ProductStatus(88);
+  expect(fetch.mock.calls[0][0]).toContain(
+    '/domains/42/storefront_v2/products/88/status/'
+  );
+});
+
 test('can get storefront v2 change request by id', () => {
   const merchi = new Merchi();
   const domain = new merchi.Domain();

package/src/entities/domain.ts

@@ -290,6 +290,8 @@ export interface StorefrontV2RollbackResult {
 export interface StorefrontV2ProductPublishResult {
   action: 'deploy' | 'recache' | string;
   productName?: string | null;
+  productId?: number | null;
+  lastDeployed?: number | null;
   status?: string;
   productUrl?: string;
   deploymentId?: string;
@@ -299,6 +301,13 @@ export interface StorefrontV2ProductPublishResult {
   httpStatus?: number;
 }
 
+export interface StorefrontV2ProductStatus {
+  activated: boolean;
+  outOfSync?: boolean;
+  lastUpdated?: number | null;
+  lastDeployed?: number | null;
+}
+
 export interface StorefrontV2CategoryPublishResult {
   action: 'deploy' | 'recache' | string;
   categoryName?: string | null;
@@ -314,6 +323,7 @@ export interface StorefrontV2CategoryPublishResult {
 export interface StorefrontV2ProductPublishPayload {
   productName?: string;
   productUrl?: string;
+  productId?: number;
   branchName?: string;
 }
 
@@ -1029,6 +1039,15 @@ export class Domain extends Entity {
     ) as Promise<{repositoryFileUpdate: StorefrontV2RepositoryFileUpdate}>;
   };
 
+  public getStorefrontV2ProductStatus = (
+    productId: number
+  ): Promise<{storefrontProductStatus: StorefrontV2ProductStatus}> => {
+    return this.storefrontV2Request(
+      this.storefrontV2DomainResource(`products/${String(productId)}/status/`),
+      'GET'
+    ) as Promise<{storefrontProductStatus: StorefrontV2ProductStatus}>;
+  };
+
   public publishStorefrontV2Product = (
     payload?: StorefrontV2ProductPublishPayload
   ): Promise<{productPublish: StorefrontV2ProductPublishResult}> => {

package/src/entities/invoice.test.ts

@@ -41,3 +41,10 @@ test('client and invoice tokens supported by merchi', () => {
   expect(fetch.mock.calls[0][1]['query']).toEqual(correct);
   return invocation;
 });
+
+test('preserves server payment engine hint', () => {
+  const merchi = new Merchi();
+  const entity = new merchi.Invoice();
+  entity.fromJson({ id: 1, stripePaymentEngine: 'wallet' });
+  expect(entity.toJson()).toMatchObject({ stripePaymentEngine: 'wallet' });
+});

package/src/entities/invoice.ts

@@ -28,6 +28,9 @@ export class Invoice extends Entity {
   @Invoice.property()
   public id?: number;
 
+  @Invoice.property()
+  public stripePaymentEngine?: string;
+
   @Invoice.property({type: Date})
   public creationDate?: Date | null;
 

package/src/entities/payment.test.ts

@@ -17,3 +17,11 @@ test('payment refund', () => {
     expect(payment.amount).toEqual(10);
   });
 });
+
+
+test('wallet method and partial refund survive API serialization', () => {
+  const payment = new (new Merchi()).Payment();
+  payment.fromJson({ id: 8, amount: 20, paymentType: 1, paymentProvider: 'stripe',
+    paymentMethod: 'wechat_pay', refundedAmount: 5, refundStatus: 'pending' });
+  expect(payment.toJson()).toMatchObject({ paymentMethod: 'wechat_pay', refundedAmount: 5, refundStatus: 'pending' });
+});

package/src/entities/payment.ts

@@ -21,6 +21,18 @@ export class Payment extends Entity {
   @Payment.property()
   public paymentType?: number;
 
+  @Payment.property()
+  public paymentProvider?: string;
+
+  @Payment.property()
+  public paymentMethod?: string;
+
+  @Payment.property()
+  public refundedAmount?: number;
+
+  @Payment.property({ type: String })
+  public refundStatus?: string | null;
+
   @Payment.property()
   public note?: string;
 

package/src/entities/product.ts

@@ -44,6 +44,9 @@ export class Product extends Entity {
   @Product.property({type: Date})
   public updated?: Date;
 
+  @Product.property({type: Date})
+  public storefrontLastDeployed?: Date | null;
+
   @Product.property({type: 'User'})
   public createdBy?: User | null;