feeef 0.12.0 → 0.12.2

package/README.md

@@ -2,6 +2,19 @@
 
 `feeefjs` is a TypeScript library for managing feeef e-commerce platforms for self-hosted stores. It provides a wrapper for feeef rest api such like send order..., also have frontend srvices like the `CartService` class for managing cart items, shipping methods, and calculating totals. The library also includes a `NotifiableService` base class for handling listeners that react to changes in the service state.
 
+## Publish to npm
+
+Non-interactive publish (no login / OTP each time): see **[PUBLISH.md](./PUBLISH.md)**.
+
+```bash
+# one-time: granular token + Bypass 2FA → ~/.config/feeef/npm_token or NPM_TOKEN
+npm run publish:npm
+# or version bump + tag + publish:
+npm run release
+```
+
+Related CLI package (separate publish): [`@feeef.dev/cli`](https://www.npmjs.com/package/@feeef.dev/cli) in monorepo `cli/`.
+
 ## Delivery parcel types
 
 Canonical shipment shapes mirror the API domain in `feeefapps/backend/services/delivery/domain/parcel.ts`. In this package they live under `src/delivery/parcel.ts` and are exported from the main entry (`ParcelCreate`, `ParcelUpdate`, `DeliveryCarrierClient`, …). Keep them in sync when the backend parcel model changes; published npm `feeef` should re-export the same definitions after each release.

package/build/index.js

@@ -141,7 +141,8 @@ var ModelRepository = class {
    * @returns A promise that resolves to the created model.
    */
   async create(dataOrOptions, params) {
-    if (dataOrOptions && typeof dataOrOptions === "object" && "data" in dataOrOptions) {
+    const looksLikeOptions = dataOrOptions && typeof dataOrOptions === "object" && "data" in dataOrOptions && Object.keys(dataOrOptions).every((k) => k === "data" || k === "params");
+    if (looksLikeOptions) {
       const options2 = dataOrOptions;
       const { data, params: optionsParams } = options2;
       const requestParams = optionsParams || params;
@@ -690,6 +691,29 @@ var StoreRepository = class extends ModelRepository {
     });
     return res.data;
   }
+  /**
+   * Upserts a draft theme preview (does not change live `metadata.templateData`).
+   */
+  async putTemplatePreview(storeId, body) {
+    const res = await this.client.put(`/${this.resource}/${storeId}/template-preview`, body);
+    return res.data;
+  }
+  /**
+   * Clears the draft theme preview for a store.
+   */
+  async clearTemplatePreview(storeId) {
+    const res = await this.client.delete(`/${this.resource}/${storeId}/template-preview`);
+    return res.data;
+  }
+  /**
+   * Fetches draft TemplateData with a signed preview token (public, token-gated).
+   */
+  async getTemplatePreview(storeId, token) {
+    const res = await this.client.get(`/${this.resource}/${storeId}/template-preview`, {
+      params: { token }
+    });
+    return res.data;
+  }
 };
 
 // src/feeef/repositories/users.ts
@@ -1168,15 +1192,18 @@ var OAuthRepository = class {
   }
   /**
    * Exchanges an authorization code for an access token.
+   * Public clients omit `clientSecret` and must send `codeVerifier` (PKCE).
    */
   async exchangeAuthorizationCode(params) {
     const body = new URLSearchParams({
       grant_type: "authorization_code",
       code: params.code,
       redirect_uri: params.redirectUri,
-      client_id: params.clientId,
-      client_secret: params.clientSecret
+      client_id: params.clientId
     });
+    if (params.clientSecret) {
+      body.set("client_secret", params.clientSecret);
+    }
     if (params.codeVerifier) {
       body.set("code_verifier", params.codeVerifier);
     }
@@ -2947,16 +2974,41 @@ var StoreTemplatesRepository = class extends ModelRepository {
     return res.data;
   }
   /**
-   * Set `stores.template_id` to this template (same row in `store_templates`)
-   * and copy `data` into `store.metadata.templateData`. Does not create a new
-   * `store_templates` row — use [fork] to duplicate a template into a store.
+   * Set `stores.template_id` (+ optional release pin) and copy release/listing
+   * `data` into `store.metadata.templateData`. Paid listings require a license.
    */
   async install(options) {
     const res = await this.client.post(`/${this.resource}/${options.fromId}/install`, {
+      storeId: options.storeId,
+      ...options.releaseId ? { releaseId: options.releaseId } : {}
+    });
+    return res.data;
+  }
+  /** One-time wallet purchase → forever store license. */
+  async purchase(options) {
+    const res = await this.client.post(`/${this.resource}/${options.fromId}/purchase`, {
       storeId: options.storeId
     });
     return res.data;
   }
+  /** List immutable releases (newest first). */
+  async listReleases(templateId, options) {
+    const res = await this.client.get(`/${this.resource}/${templateId}/releases`, {
+      params: options?.storeId ? { storeId: options.storeId } : void 0
+    });
+    return res.data;
+  }
+  async getRelease(templateId, releaseId, options) {
+    const res = await this.client.get(`/${this.resource}/${templateId}/releases/${releaseId}`, {
+      params: options?.storeId ? { storeId: options.storeId } : void 0
+    });
+    return res.data;
+  }
+  /** Author publishes a new immutable release. */
+  async createRelease(templateId, input) {
+    const res = await this.client.post(`/${this.resource}/${templateId}/releases`, input);
+    return res.data;
+  }
   /** GET locales bundle (`defaultLocale`, `locales`, `messages`). */
   async listLocales(templateId) {
     const res = await this.client.get(`/${this.resource}/${templateId}/locales`);