stated-protocol-parser 1.0.0 → 1.0.2

package/dist/hash.browser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Browser-compatible hash utilities using Web Crypto API
+ * Async operations for client-side use
+ */
+/**
+ * Compute SHA-256 hash of a string and return it as URL-safe base64
+ * Works in both browser and Node.js environments
+ * @param input - The string or buffer to hash
+ * @returns URL-safe base64 encoded hash
+ */
+export declare const sha256: (input: string | Uint8Array) => Promise<string>;
+/**
+ * Verify that content matches a given hash
+ * @param content - The content to verify
+ * @param hash - The expected hash
+ * @returns True if the hash matches
+ */
+export declare const verify: (content: string | Uint8Array, hash: string) => Promise<boolean>;
+/**
+ * Convert URL-safe base64 back to standard base64
+ * @param urlSafe - URL-safe base64 string
+ * @returns Standard base64 string with padding
+ */
+export declare const fromUrlSafeBase64: (urlSafe: string) => string;
+/**
+ * Convert standard base64 to URL-safe base64
+ * @param base64 - Standard base64 string
+ * @returns URL-safe base64 string without padding
+ */
+export declare const toUrlSafeBase64: (base64: string) => string;

package/dist/hash.browser.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Browser-compatible hash utilities using Web Crypto API
+ * Async operations for client-side use
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toUrlSafeBase64 = exports.fromUrlSafeBase64 = exports.verify = exports.sha256 = void 0;
+/**
+ * Compute SHA-256 hash of a string and return it as URL-safe base64
+ * Works in both browser and Node.js environments
+ * @param input - The string or buffer to hash
+ * @returns URL-safe base64 encoded hash
+ */
+const sha256 = async (input) => {
+    let data;
+    if (typeof input === 'string') {
+        const encoder = new TextEncoder();
+        data = encoder.encode(input);
+    }
+    else {
+        data = input;
+    }
+    // Use Web Crypto API (available in both modern browsers and Node.js 15+)
+    const hashBuffer = await crypto.subtle.digest('SHA-256', data);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    // Convert to base64
+    const base64 = btoa(String.fromCharCode(...hashArray));
+    // Make URL-safe: remove padding and replace + with - and / with _
+    const urlSafe = base64.replace(/=/g, '').replace(/\+/g, '-').replace(/\//g, '_');
+    return urlSafe;
+};
+exports.sha256 = sha256;
+/**
+ * Verify that content matches a given hash
+ * @param content - The content to verify
+ * @param hash - The expected hash
+ * @returns True if the hash matches
+ */
+const verify = async (content, hash) => {
+    const computed = await (0, exports.sha256)(content);
+    return computed === hash;
+};
+exports.verify = verify;
+/**
+ * Convert URL-safe base64 back to standard base64
+ * @param urlSafe - URL-safe base64 string
+ * @returns Standard base64 string with padding
+ */
+const fromUrlSafeBase64 = (urlSafe) => {
+    const base64 = urlSafe.replace(/-/g, '+').replace(/_/g, '/');
+    // Add padding if needed
+    const padding = '='.repeat((4 - (base64.length % 4)) % 4);
+    return base64 + padding;
+};
+exports.fromUrlSafeBase64 = fromUrlSafeBase64;
+/**
+ * Convert standard base64 to URL-safe base64
+ * @param base64 - Standard base64 string
+ * @returns URL-safe base64 string without padding
+ */
+const toUrlSafeBase64 = (base64) => {
+    return base64.replace(/=/g, '').replace(/\+/g, '-').replace(/\//g, '_');
+};
+exports.toUrlSafeBase64 = toUrlSafeBase64;

package/dist/hash.node.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Node.js-specific hash utilities using native crypto module
+ * Synchronous operations for server-side use
+ */
+import crypto from 'crypto';
+/**
+ * Compute SHA-256 hash and return as URL-safe base64 (Node.js)
+ * @param input - String or buffer to hash
+ * @returns URL-safe base64 encoded hash
+ */
+export declare const sha256: (input: crypto.BinaryLike) => string;
+/**
+ * Verify that content matches a given hash
+ * @param content - Content to verify
+ * @param hash - Expected hash
+ * @returns True if hash matches
+ */
+export declare const verify: (content: crypto.BinaryLike, hash: string) => boolean;
+/**
+ * Convert URL-safe base64 back to standard base64
+ * @param urlSafe - URL-safe base64 string
+ * @returns Standard base64 string with padding
+ */
+export declare const fromUrlSafeBase64: (urlSafe: string) => string;
+/**
+ * Convert standard base64 to URL-safe base64
+ * @param base64 - Standard base64 string
+ * @returns URL-safe base64 string without padding
+ */
+export declare const toUrlSafeBase64: (base64: string) => string;

package/dist/hash.node.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Node.js-specific hash utilities using native crypto module
+ * Synchronous operations for server-side use
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toUrlSafeBase64 = exports.fromUrlSafeBase64 = exports.verify = exports.sha256 = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+/**
+ * Compute SHA-256 hash and return as URL-safe base64 (Node.js)
+ * @param input - String or buffer to hash
+ * @returns URL-safe base64 encoded hash
+ */
+const sha256 = (input) => {
+    const base64 = crypto_1.default.createHash('sha256').update(input).digest('base64');
+    const urlSafe = base64.replace(/=/g, '').replace(/\+/g, '-').replace(/\//g, '_');
+    return urlSafe;
+};
+exports.sha256 = sha256;
+/**
+ * Verify that content matches a given hash
+ * @param content - Content to verify
+ * @param hash - Expected hash
+ * @returns True if hash matches
+ */
+const verify = (content, hash) => {
+    return hash === (0, exports.sha256)(content);
+};
+exports.verify = verify;
+/**
+ * Convert URL-safe base64 back to standard base64
+ * @param urlSafe - URL-safe base64 string
+ * @returns Standard base64 string with padding
+ */
+const fromUrlSafeBase64 = (urlSafe) => {
+    const base64 = urlSafe.replace(/-/g, '+').replace(/_/g, '/');
+    const padding = '='.repeat((4 - (base64.length % 4)) % 4);
+    return base64 + padding;
+};
+exports.fromUrlSafeBase64 = fromUrlSafeBase64;
+/**
+ * Convert standard base64 to URL-safe base64
+ * @param base64 - Standard base64 string
+ * @returns URL-safe base64 string without padding
+ */
+const toUrlSafeBase64 = (base64) => {
+    return base64.replace(/=/g, '').replace(/\+/g, '-').replace(/\//g, '_');
+};
+exports.toUrlSafeBase64 = toUrlSafeBase64;

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './types';
 export * from './constants';
 export * from './utils';
 export * from './v3';
+export * from './hash.browser';
 export declare const buildStatement: ({ domain, author, time, tags, content, representative, supersededStatement }: Statement) => string;
 export declare const parseStatement: ({ statement: s, allowNoVersion }: {
     statement: string;

package/dist/index.js

@@ -25,6 +25,7 @@ __exportStar(require("./types"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./utils"), exports);
 __exportStar(require("./v3"), exports);
+__exportStar(require("./hash.browser"), exports);
 const buildStatement = ({ domain, author, time, tags, content, representative, supersededStatement }) => {
     if (content.match(/\nPublishing domain: /))
         throw (new Error("Statement must not contain 'Publishing domain: ', as this marks the beginning of a new statement."));

package/package.json

@@ -1,9 +1,26 @@
 {
   "name": "stated-protocol-parser",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Parser and formatter for the Stated protocol - a decentralized statement verification system",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./hash.node": {
+      "import": "./dist/hash.node.js",
+      "require": "./dist/hash.node.js",
+      "types": "./dist/hash.node.d.ts"
+    },
+    "./hash.browser": {
+      "import": "./dist/hash.browser.js",
+      "require": "./dist/hash.browser.js",
+      "types": "./dist/hash.browser.d.ts"
+    }
+  },
   "scripts": {
     "build": "tsc",
     "test": "jest",