@alien_org/contract 0.1.4 → 0.2.1

package/dist/index.cjs

@@ -34,8 +34,24 @@ function getReleaseVersion(method, payload) {
 //#endregion
 //#region src/methods/versions/index.ts
 /**
+* Compare two semver versions.
+* @returns negative if a < b, 0 if a === b, positive if a > b
+*/
+function compareVersions(a, b) {
+	const [aMajor, aMinor, aPatch] = a.split(".").map(Number);
+	const [bMajor, bMinor, bPatch] = b.split(".").map(Number);
+	if (aMajor !== bMajor) return (aMajor ?? 0) - (bMajor ?? 0);
+	if (aMinor !== bMinor) return (aMinor ?? 0) - (bMinor ?? 0);
+	return (aPatch ?? 0) - (bPatch ?? 0);
+}
+/**
 * Check if a method is supported in a given version.
 *
+* Uses the minimum version that introduced the method and returns true if
+* the given version is >= that minimum (semver comparison). This supports
+* versions not explicitly listed in releases (e.g. 0.1.4 when method was
+* added in 0.1.1).
+*
 * @param method - The method name to check.
 * @param version - The contract version (must be a valid version string, not undefined).
 * @returns `true` if the method is supported in the given version, `false` otherwise.
@@ -45,22 +61,16 @@ function getReleaseVersion(method, payload) {
 * handled at a higher level before calling this function.
 */
 function isMethodSupported(method, version) {
-	const methods = releases[version];
-	if (!methods) return false;
-	return methods.some((m) => typeof m === "string" ? m === method : m.method === method);
+	const minVersion = getMethodMinVersion(method);
+	if (!minVersion) return false;
+	return compareVersions(version, minVersion) >= 0;
 }
 /**
 * Get the minimum version that supports a method.
 * Returns undefined if method not found in any version.
 */
 function getMethodMinVersion(method) {
-	const sorted = Object.keys(releases).sort((a, b) => {
-		const [aMajor, aMinor, aPatch] = a.split(".").map(Number);
-		const [bMajor, bMinor, bPatch] = b.split(".").map(Number);
-		if (aMajor !== bMajor) return (aMajor ?? 0) - (bMajor ?? 0);
-		if (aMinor !== bMinor) return (aMinor ?? 0) - (bMinor ?? 0);
-		return (aPatch ?? 0) - (bPatch ?? 0);
-	});
+	const sorted = Object.keys(releases).sort(compareVersions);
 	for (const version of sorted) {
 		const methods = releases[version];
 		if (!methods) continue;

package/dist/index.d.cts

@@ -269,8 +269,9 @@ interface Methods {
    * Optional display fields (`title`, `caption`, `iconUrl`, `quantity`)
    * are shown on the payment approval screen.
    *
-   * Set `test: true` for test mode - no real payment is made, but webhooks
-   * are fired with `test: true` flag. Use for development and testing.
+   * Set `test` to a scenario string (e.g. `'paid'`, `'error:insufficient_balance'`)
+   * for test mode - no real payment is made, but the specified scenario is
+   * simulated. Use for development and testing.
    *
    * @since 0.1.1
    * @schema
@@ -336,7 +337,7 @@ interface Methods {
      *
      * | Scenario | Client | Webhook |
      * |----------|--------|---------|
-     * | `true` / `'paid'` | `paid` | `finalized` |
+     * | `'paid'` | `paid` | `finalized` |
      * | `'paid:failed'` | `paid` | `failed` |
      * | `'cancelled'` | `cancelled` | none |
      * | `'error:*'` | `failed` | none |
@@ -362,7 +363,7 @@ interface Methods {
      * @since 0.1.1
      * @schema
      */
-    test?: boolean | PaymentTestScenario;
+    test?: PaymentTestScenario;
   }>>;
   /**
    * Write text to the system clipboard.
@@ -455,6 +456,11 @@ declare const releases: Record<Version, (MethodName | {
 /**
  * Check if a method is supported in a given version.
  *
+ * Uses the minimum version that introduced the method and returns true if
+ * the given version is >= that minimum (semver comparison). This supports
+ * versions not explicitly listed in releases (e.g. 0.1.4 when method was
+ * added in 0.1.1).
+ *
  * @param method - The method name to check.
  * @param version - The contract version (must be a valid version string, not undefined).
  * @returns `true` if the method is supported in the given version, `false` otherwise.

package/dist/index.d.mts

@@ -269,8 +269,9 @@ interface Methods {
    * Optional display fields (`title`, `caption`, `iconUrl`, `quantity`)
    * are shown on the payment approval screen.
    *
-   * Set `test: true` for test mode - no real payment is made, but webhooks
-   * are fired with `test: true` flag. Use for development and testing.
+   * Set `test` to a scenario string (e.g. `'paid'`, `'error:insufficient_balance'`)
+   * for test mode - no real payment is made, but the specified scenario is
+   * simulated. Use for development and testing.
    *
    * @since 0.1.1
    * @schema
@@ -336,7 +337,7 @@ interface Methods {
      *
      * | Scenario | Client | Webhook |
      * |----------|--------|---------|
-     * | `true` / `'paid'` | `paid` | `finalized` |
+     * | `'paid'` | `paid` | `finalized` |
      * | `'paid:failed'` | `paid` | `failed` |
      * | `'cancelled'` | `cancelled` | none |
      * | `'error:*'` | `failed` | none |
@@ -362,7 +363,7 @@ interface Methods {
      * @since 0.1.1
      * @schema
      */
-    test?: boolean | PaymentTestScenario;
+    test?: PaymentTestScenario;
   }>>;
   /**
    * Write text to the system clipboard.
@@ -455,6 +456,11 @@ declare const releases: Record<Version, (MethodName | {
 /**
  * Check if a method is supported in a given version.
  *
+ * Uses the minimum version that introduced the method and returns true if
+ * the given version is >= that minimum (semver comparison). This supports
+ * versions not explicitly listed in releases (e.g. 0.1.4 when method was
+ * added in 0.1.1).
+ *
  * @param method - The method name to check.
  * @param version - The contract version (must be a valid version string, not undefined).
  * @returns `true` if the method is supported in the given version, `false` otherwise.

package/dist/index.mjs

@@ -33,8 +33,24 @@ function getReleaseVersion(method, payload) {
 //#endregion
 //#region src/methods/versions/index.ts
 /**
+* Compare two semver versions.
+* @returns negative if a < b, 0 if a === b, positive if a > b
+*/
+function compareVersions(a, b) {
+	const [aMajor, aMinor, aPatch] = a.split(".").map(Number);
+	const [bMajor, bMinor, bPatch] = b.split(".").map(Number);
+	if (aMajor !== bMajor) return (aMajor ?? 0) - (bMajor ?? 0);
+	if (aMinor !== bMinor) return (aMinor ?? 0) - (bMinor ?? 0);
+	return (aPatch ?? 0) - (bPatch ?? 0);
+}
+/**
 * Check if a method is supported in a given version.
 *
+* Uses the minimum version that introduced the method and returns true if
+* the given version is >= that minimum (semver comparison). This supports
+* versions not explicitly listed in releases (e.g. 0.1.4 when method was
+* added in 0.1.1).
+*
 * @param method - The method name to check.
 * @param version - The contract version (must be a valid version string, not undefined).
 * @returns `true` if the method is supported in the given version, `false` otherwise.
@@ -44,22 +60,16 @@ function getReleaseVersion(method, payload) {
 * handled at a higher level before calling this function.
 */
 function isMethodSupported(method, version) {
-	const methods = releases[version];
-	if (!methods) return false;
-	return methods.some((m) => typeof m === "string" ? m === method : m.method === method);
+	const minVersion = getMethodMinVersion(method);
+	if (!minVersion) return false;
+	return compareVersions(version, minVersion) >= 0;
 }
 /**
 * Get the minimum version that supports a method.
 * Returns undefined if method not found in any version.
 */
 function getMethodMinVersion(method) {
-	const sorted = Object.keys(releases).sort((a, b) => {
-		const [aMajor, aMinor, aPatch] = a.split(".").map(Number);
-		const [bMajor, bMinor, bPatch] = b.split(".").map(Number);
-		if (aMajor !== bMajor) return (aMajor ?? 0) - (bMajor ?? 0);
-		if (aMinor !== bMinor) return (aMinor ?? 0) - (bMinor ?? 0);
-		return (aPatch ?? 0) - (bPatch ?? 0);
-	});
+	const sorted = Object.keys(releases).sort(compareVersions);
 	for (const version of sorted) {
 		const methods = releases[version];
 		if (!methods) continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alien_org/contract",
-  "version": "0.1.4",
+  "version": "0.2.1",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",