@ocap/util 1.29.14 → 1.29.16

package/esm/index.d.mts

@@ -1,4 +1,5 @@
 import { BN } from "./bn.mjs";
+import { scopeMatch, scopeMatchAny } from "./scope-match.mjs";
 import rightPad from "lodash/padEnd.js";
 import leftPad from "lodash/padStart.js";
 import { LiteralUnion } from "type-fest";
@@ -219,4 +220,4 @@ declare function toDid(address: string): string;
 declare function isSameDid(a: string, b: string): boolean;
 declare function formatTxType(type: string): Capitalize<string>;
 //#endregion
-export { BN, BytesType, EncodingType, KeyPairType, UUID, bytesToHex, formatTxType, fromBase58, fromBase64, fromTokenToUnit, fromUnitToToken, hexToBytes, hexToNumber, hexToUtf8, isBN, isBase58btc, isBigNumber, isHex, isHexPrefixed, isHexStrict, isSameDid, isUUID, isUint8Array, leftPad, numberToBN, numberToHex, numberToString, rightPad, stripHexPrefix, toAddress, toBN, toBase58, toBase64, toBuffer, toDid, toHex, toUint8Array, utf8ToHex };
+export { BN, BytesType, EncodingType, KeyPairType, UUID, bytesToHex, formatTxType, fromBase58, fromBase64, fromTokenToUnit, fromUnitToToken, hexToBytes, hexToNumber, hexToUtf8, isBN, isBase58btc, isBigNumber, isHex, isHexPrefixed, isHexStrict, isSameDid, isUUID, isUint8Array, leftPad, numberToBN, numberToHex, numberToString, rightPad, scopeMatch, scopeMatchAny, stripHexPrefix, toAddress, toBN, toBase58, toBase64, toBuffer, toDid, toHex, toUint8Array, utf8ToHex };

package/esm/index.mjs

@@ -1,4 +1,5 @@
 import { BN } from "./bn.mjs";
+import { scopeMatch, scopeMatchAny } from "./scope-match.mjs";
 import BaseBN from "bn.js";
 import base64 from "base64-url";
 import base58 from "bs58";
@@ -425,4 +426,4 @@ function formatTxType(type) {
 }
 
 //#endregion
-export { BN, UUID, bytesToHex, formatTxType, fromBase58, fromBase64, fromTokenToUnit, fromUnitToToken, hexToBytes, hexToNumber, hexToUtf8, isBN, isBase58btc, isBigNumber, isHex, isHexPrefixed, isHexStrict, isSameDid, isUUID, isUint8Array, leftPad, numberToBN, numberToHex, numberToString, rightPad, stripHexPrefix, toAddress, toBN, toBase58, toBase64, toBuffer, toDid, toHex, toUint8Array, utf8ToHex };
+export { BN, UUID, bytesToHex, formatTxType, fromBase58, fromBase64, fromTokenToUnit, fromUnitToToken, hexToBytes, hexToNumber, hexToUtf8, isBN, isBase58btc, isBigNumber, isHex, isHexPrefixed, isHexStrict, isSameDid, isUUID, isUint8Array, leftPad, numberToBN, numberToHex, numberToString, rightPad, scopeMatch, scopeMatchAny, stripHexPrefix, toAddress, toBN, toBase58, toBase64, toBuffer, toDid, toHex, toUint8Array, utf8ToHex };

package/esm/scope-match.d.mts

@@ -0,0 +1,17 @@
+//#region src/scope-match.d.ts
+/**
+ * Check if a scope matches a pattern.
+ *
+ * Matching rules:
+ * - Exact match: 'fg:t:transfer' matches 'fg:t:transfer'
+ * - Wildcard: 'fg:t:transfer' matches 'fg:t:*' (pattern ends with ':*')
+ * - Prefix with segment boundary: 'fg:x:connect:authPrincipal' matches 'fg:x:connect'
+ *   but 'fg:x:connectFoo' does NOT match 'fg:x:connect'
+ */
+declare function scopeMatch(scope: string, pattern: string): boolean;
+/**
+ * Check if a scope matches any of the given patterns.
+ */
+declare function scopeMatchAny(scope: string, patterns: string[]): boolean;
+//#endregion
+export { scopeMatch, scopeMatchAny };

package/esm/scope-match.mjs

@@ -0,0 +1,24 @@
+//#region src/scope-match.ts
+/**
+* Check if a scope matches a pattern.
+*
+* Matching rules:
+* - Exact match: 'fg:t:transfer' matches 'fg:t:transfer'
+* - Wildcard: 'fg:t:transfer' matches 'fg:t:*' (pattern ends with ':*')
+* - Prefix with segment boundary: 'fg:x:connect:authPrincipal' matches 'fg:x:connect'
+*   but 'fg:x:connectFoo' does NOT match 'fg:x:connect'
+*/
+function scopeMatch(scope, pattern) {
+	if (scope === pattern) return true;
+	if (pattern.endsWith(":*")) return scope.startsWith(pattern.slice(0, -1));
+	return scope.startsWith(`${pattern}:`);
+}
+/**
+* Check if a scope matches any of the given patterns.
+*/
+function scopeMatchAny(scope, patterns) {
+	return patterns.some((p) => scopeMatch(scope, p));
+}
+
+//#endregion
+export { scopeMatch, scopeMatchAny };

package/lib/index.cjs

@@ -1,5 +1,6 @@
 const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
 const require_bn = require('./bn.cjs');
+const require_scope_match = require('./scope-match.cjs');
 let bn_js = require("bn.js");
 bn_js = require_rolldown_runtime.__toESM(bn_js);
 let base64_url = require("base64-url");
@@ -464,6 +465,8 @@ exports.numberToBN = numberToBN;
 exports.numberToHex = numberToHex;
 exports.numberToString = numberToString;
 exports.rightPad = lodash_padEnd.default;
+exports.scopeMatch = require_scope_match.scopeMatch;
+exports.scopeMatchAny = require_scope_match.scopeMatchAny;
 exports.stripHexPrefix = stripHexPrefix;
 exports.toAddress = toAddress;
 exports.toBN = toBN;

package/lib/index.d.cts

@@ -1,4 +1,5 @@
 import { BN } from "./bn.cjs";
+import { scopeMatch, scopeMatchAny } from "./scope-match.cjs";
 import rightPad from "lodash/padEnd";
 import leftPad from "lodash/padStart";
 import { LiteralUnion } from "type-fest";
@@ -219,4 +220,4 @@ declare function toDid(address: string): string;
 declare function isSameDid(a: string, b: string): boolean;
 declare function formatTxType(type: string): Capitalize<string>;
 //#endregion
-export { BN, BytesType, EncodingType, KeyPairType, UUID, bytesToHex, formatTxType, fromBase58, fromBase64, fromTokenToUnit, fromUnitToToken, hexToBytes, hexToNumber, hexToUtf8, isBN, isBase58btc, isBigNumber, isHex, isHexPrefixed, isHexStrict, isSameDid, isUUID, isUint8Array, leftPad, numberToBN, numberToHex, numberToString, rightPad, stripHexPrefix, toAddress, toBN, toBase58, toBase64, toBuffer, toDid, toHex, toUint8Array, utf8ToHex };
+export { BN, BytesType, EncodingType, KeyPairType, UUID, bytesToHex, formatTxType, fromBase58, fromBase64, fromTokenToUnit, fromUnitToToken, hexToBytes, hexToNumber, hexToUtf8, isBN, isBase58btc, isBigNumber, isHex, isHexPrefixed, isHexStrict, isSameDid, isUUID, isUint8Array, leftPad, numberToBN, numberToHex, numberToString, rightPad, scopeMatch, scopeMatchAny, stripHexPrefix, toAddress, toBN, toBase58, toBase64, toBuffer, toDid, toHex, toUint8Array, utf8ToHex };

package/lib/scope-match.cjs

@@ -0,0 +1,26 @@
+
+//#region src/scope-match.ts
+/**
+* Check if a scope matches a pattern.
+*
+* Matching rules:
+* - Exact match: 'fg:t:transfer' matches 'fg:t:transfer'
+* - Wildcard: 'fg:t:transfer' matches 'fg:t:*' (pattern ends with ':*')
+* - Prefix with segment boundary: 'fg:x:connect:authPrincipal' matches 'fg:x:connect'
+*   but 'fg:x:connectFoo' does NOT match 'fg:x:connect'
+*/
+function scopeMatch(scope, pattern) {
+	if (scope === pattern) return true;
+	if (pattern.endsWith(":*")) return scope.startsWith(pattern.slice(0, -1));
+	return scope.startsWith(`${pattern}:`);
+}
+/**
+* Check if a scope matches any of the given patterns.
+*/
+function scopeMatchAny(scope, patterns) {
+	return patterns.some((p) => scopeMatch(scope, p));
+}
+
+//#endregion
+exports.scopeMatch = scopeMatch;
+exports.scopeMatchAny = scopeMatchAny;

package/lib/scope-match.d.cts

@@ -0,0 +1,17 @@
+//#region src/scope-match.d.ts
+/**
+ * Check if a scope matches a pattern.
+ *
+ * Matching rules:
+ * - Exact match: 'fg:t:transfer' matches 'fg:t:transfer'
+ * - Wildcard: 'fg:t:transfer' matches 'fg:t:*' (pattern ends with ':*')
+ * - Prefix with segment boundary: 'fg:x:connect:authPrincipal' matches 'fg:x:connect'
+ *   but 'fg:x:connectFoo' does NOT match 'fg:x:connect'
+ */
+declare function scopeMatch(scope: string, pattern: string): boolean;
+/**
+ * Check if a scope matches any of the given patterns.
+ */
+declare function scopeMatchAny(scope: string, patterns: string[]): boolean;
+//#endregion
+export { scopeMatch, scopeMatchAny };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ocap/util",
-  "version": "1.29.14",
+  "version": "1.29.16",
   "type": "module",
   "description": "utils shared across multiple forge js libs, works in both node.js and browser",
   "keywords": [
@@ -12,7 +12,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@ocap/types": "1.29.14",
+    "@ocap/types": "1.29.16",
     "@types/bn.js": "^5.2.0",
     "base64-url": "^2.3.3",
     "bn.js": "5.2.3",