@brninpay/core 0.1.0 → 1.1.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
-
-> @brninpay/core@0.1.0 build /home/runner/work/brninpay/brninpay/packages/core
-> tsc
-
+
+> @brninpay/core@1.1.0 build /home/bernieweb3/Downloads/runtimee/packages/core
+> tsc
+

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @brninpay/core@0.1.0 typecheck /home/bernieweb3/Downloads/runtimee/packages/core
+> tsc --noEmit
+

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @brninpay/core
+
+## 1.1.0
+
+### Minor Changes
+
+- ea45d4c: Minor fixes
+
+## 1.0.0
+
+### Major Changes
+
+- 5fc7f42: Brninpay is here! From BernieWeb3 a.k.a NxBern with love :3

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2026 Runtimee Authors
+Copyright 2026 Brninpay Authors
 
                                  Apache License
                             Version 2.0, January 2004

package/README.md

@@ -1,7 +1,109 @@
-# @runtimee/core
+# @brninpay/core
 
-Pure TypeScript authorization kernel for Runtimee.
+Pure TypeScript authorization kernel for Brninpay. Zero blockchain dependencies. Zero I/O. Zero network calls.
 
-Zero blockchain dependencies. Zero I/O. Zero network calls.
+## Install
 
-Provides the PolicyEngine, DecisionResolver, and built-in policies that form the core authorization pipeline.
+```bash
+npm install @brninpay/core
+```
+
+## Usage
+
+### Policy Engine
+
+Evaluate spending requests against composable policies:
+
+```ts
+import { PolicyEngine, createBudgetCheckPolicy, createAllowlistPolicy } from '@brninpay/core'
+
+const engine = new PolicyEngine()
+
+engine.addPolicy(createBudgetCheckPolicy({
+  maxAmount: '1000',
+  currency: 'USDC',
+  period: 'monthly',
+}))
+
+engine.addPolicy(createAllowlistPolicy({
+  allowedTargets: ['0x1234...'],
+}))
+
+const decision = await engine.evaluate({
+  target: '0x1234...',
+  amount: '500000000',          // 500 USDC (6 decimals)
+  purpose: { type: 'payment', id: 'inv_001' },
+  budget: { used: '100000000', total: '1000000000' },
+})
+```
+
+### Built-in Policies
+
+| Policy | Import | Purpose |
+|--------|--------|---------|
+| Budget Check | `createBudgetCheckPolicy` | Enforce monthly/total spending caps |
+| Allowlist | `createAllowlistPolicy` | Restrict to approved target addresses |
+| Max Per Call | `createMaxPerCallPolicy` | Cap individual payment amounts |
+| Rate Limit | `createRateLimitPolicy` | Limit payments per time window |
+
+### Decision Resolver
+
+Combine multiple policy evaluators with configurable logic:
+
+```ts
+import { DecisionResolver } from '@brninpay/core'
+
+const resolver = new DecisionResolver({
+  mode: 'all',        // 'all' | 'any' | 'weighted'
+  allowUndecided: false,
+})
+
+const result = await resolver.resolve(evaluators, context)
+```
+
+### Cryptographic Helpers
+
+```ts
+import { sha256Hex, signHmacSha256, verifyHmacSha256, generateNonce } from '@brninpay/core'
+
+const signature = await signHmacSha256('my-secret', 'message')
+const isValid = await verifyHmacSha256('my-secret', 'message', signature)
+const nonce = generateNonce()
+```
+
+### Type-Safe Parsing (Zod)
+
+Parse and validate untrusted input:
+
+```ts
+import { parsePaymentIntent, parsePolicyDefinition, parseUserOperation } from '@brninpay/core'
+
+const intent = parsePaymentIntent(untrustedData)
+const policy = parsePolicyDefinition(userInput)
+```
+
+## API
+
+### PolicyEngine
+
+- `engine.addPolicy(middleware)` — Register a policy middleware
+- `engine.removePolicy(name)` — Remove by name
+- `engine.evaluate(context)` → `AggregatedPolicyDecision`
+- `engine.getPolicies()` → `PolicyMiddleware[]`
+
+### DecisionResolver
+
+- `new DecisionResolver(config)` — `mode`: `'all'` (default, require all approve), `'any'`, `'weighted`
+- `resolver.resolve(evaluators, context)` → `AuthorizationDecision`
+
+### Type Exports
+
+`Actor`, `Intent`, `Policy`, `Budget`, `Authorization`, `ExecutionPlan`, `PaymentIntent`, `UserOperation`, `SmartWallet`, `PolicyDefinition`, `PolicyEvaluationResult`, and more — see `src/types.ts`.
+
+### Error Classes
+
+`BrninpayError`, `ValidationError`, `AuthorizationError`, `BudgetExhaustedError`, `AllowlistDeniedError`, `RateLimitExceededError`, `ExecutionError`, `NetworkError`, `HmacVerificationError`
+
+### Validation Schemas (Zod)
+
+`PaymentIntentSchema`, `PolicyDefinitionSchema`, `UserOperationSchema`, `AddressSchema`, `HexSchema`, and more — see `src/validation/schemas.ts`.

package/dist/errors.d.ts

@@ -1,3 +1,3 @@
-export { ErrorCode, RuntimeeError, ValidationError, AuthorizationError, BudgetExhaustedError, AllowlistDeniedError, RateLimitExceededError, AuthorizationExpiredError, ExecutionError, NetworkError, GasEstimationError, BroadcastError, ReorgDetectedError, HmacVerificationError, isRuntimeeError, serializeError, } from './types/errors.js';
+export { ErrorCode, BrninpayError, ValidationError, AuthorizationError, BudgetExhaustedError, AllowlistDeniedError, RateLimitExceededError, AuthorizationExpiredError, ExecutionError, NetworkError, GasEstimationError, BroadcastError, ReorgDetectedError, HmacVerificationError, isBrninpayError, serializeError, } from './types/errors.js';
 export type { ErrorCodeMessage, SerializedError } from './types/errors.js';
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.js

@@ -1,2 +1,2 @@
-export { ErrorCode, RuntimeeError, ValidationError, AuthorizationError, BudgetExhaustedError, AllowlistDeniedError, RateLimitExceededError, AuthorizationExpiredError, ExecutionError, NetworkError, GasEstimationError, BroadcastError, ReorgDetectedError, HmacVerificationError, isRuntimeeError, serializeError, } from './types/errors.js';
+export { ErrorCode, BrninpayError, ValidationError, AuthorizationError, BudgetExhaustedError, AllowlistDeniedError, RateLimitExceededError, AuthorizationExpiredError, ExecutionError, NetworkError, GasEstimationError, BroadcastError, ReorgDetectedError, HmacVerificationError, isBrninpayError, serializeError, } from './types/errors.js';
 //# sourceMappingURL=errors.js.map

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export type { Actor, Budget, Policy, SettlementDescriptor, Target, Purpose, Intent, BudgetState, PolicyResult, AuthorizationDecision, Authorization, SettlementHint, ExecutionPlan, PolicyContext, PolicyMiddleware, PolicyEvaluator, SimulationResult, SignedTransaction, Receipt, PaymentIntentStatus, PaymentAmount, PaymentRecipient, PaymentIntentFailure, PaymentMetadataValue, PaymentIntent, SerializedBigInt, PolicyDecision, PolicyReason, BasePolicy, BudgetPolicy, AllowlistPolicy, RateLimitPolicy, PolicyDefinition, PolicyEvaluationContext, PolicyEvaluationResult, AggregatedPolicyDecision, Hex, Address, SmartWalletProvider, EntryPointVersion, SmartWallet, UserOperationCall, GasEstimate, UserOperationV06, UserOperationV07, UserOperation, } from './types.js';
-export { AuthorizationError, BudgetExhaustedError, AllowlistDeniedError, RateLimitExceededError, AuthorizationExpiredError, RuntimeeError, ValidationError, ExecutionError, NetworkError, GasEstimationError, BroadcastError, ReorgDetectedError, HmacVerificationError, isRuntimeeError, serializeError, ErrorCode, } from './errors.js';
+export { AuthorizationError, BudgetExhaustedError, AllowlistDeniedError, RateLimitExceededError, AuthorizationExpiredError, BrninpayError, ValidationError, ExecutionError, NetworkError, GasEstimationError, BroadcastError, ReorgDetectedError, HmacVerificationError, isBrninpayError, serializeError, ErrorCode, } from './errors.js';
 export type { ErrorCodeMessage, SerializedError } from './errors.js';
 export { PAYMENT_INTENT_STATUSES, PAYMENT_INTENT_TERMINAL_STATUSES, PAYMENT_INTENT_TRANSITIONS, validatePaymentAmount, isPaymentIntentTerminalStatus, canTransitionPaymentIntentStatus, assertValidPaymentIntentTransition, assertPaymentIntent, serializeBigInts, deserializeBigInts, serializePaymentIntent, deserializePaymentIntent, POLICY_DECISIONS, evaluatePolicy, aggregatePolicyDecisions, evaluatePolicies, isUserOperationV06, isUserOperationV07, getUserOperationSender, getUserOperationNonce, } from './types.js';
 export { DecisionResolver } from './decision-resolver.js';

package/dist/index.js

@@ -1,4 +1,4 @@
-export { AuthorizationError, BudgetExhaustedError, AllowlistDeniedError, RateLimitExceededError, AuthorizationExpiredError, RuntimeeError, ValidationError, ExecutionError, NetworkError, GasEstimationError, BroadcastError, ReorgDetectedError, HmacVerificationError, isRuntimeeError, serializeError, ErrorCode, } from './errors.js';
+export { AuthorizationError, BudgetExhaustedError, AllowlistDeniedError, RateLimitExceededError, AuthorizationExpiredError, BrninpayError, ValidationError, ExecutionError, NetworkError, GasEstimationError, BroadcastError, ReorgDetectedError, HmacVerificationError, isBrninpayError, serializeError, ErrorCode, } from './errors.js';
 export { PAYMENT_INTENT_STATUSES, PAYMENT_INTENT_TERMINAL_STATUSES, PAYMENT_INTENT_TRANSITIONS, validatePaymentAmount, isPaymentIntentTerminalStatus, canTransitionPaymentIntentStatus, assertValidPaymentIntentTransition, assertPaymentIntent, serializeBigInts, deserializeBigInts, serializePaymentIntent, deserializePaymentIntent, POLICY_DECISIONS, evaluatePolicy, aggregatePolicyDecisions, evaluatePolicies, isUserOperationV06, isUserOperationV07, getUserOperationSender, getUserOperationNonce, } from './types.js';
 export { DecisionResolver } from './decision-resolver.js';
 export { PolicyEngine } from './policy-engine.js';

package/dist/types/errors.d.ts

@@ -23,17 +23,17 @@ export interface SerializedError {
     statusCode: number;
     details?: unknown;
 }
-export declare class RuntimeeError extends Error {
+export declare class BrninpayError extends Error {
     readonly code: string;
     readonly statusCode: number;
     readonly details?: unknown;
     constructor(code: string, message: string, statusCode?: number, details?: unknown, options?: ErrorOptions);
     toJSON(): SerializedError;
 }
-export declare class ValidationError extends RuntimeeError {
+export declare class ValidationError extends BrninpayError {
     constructor(message: string, details?: unknown, options?: ErrorOptions);
 }
-export declare class AuthorizationError extends RuntimeeError {
+export declare class AuthorizationError extends BrninpayError {
     constructor(code: string, message: string, details?: unknown, options?: ErrorOptions);
 }
 export declare class BudgetExhaustedError extends AuthorizationError {
@@ -56,7 +56,7 @@ export declare class RateLimitExceededError extends AuthorizationError {
 export declare class AuthorizationExpiredError extends AuthorizationError {
     constructor(options?: ErrorOptions);
 }
-export declare class ExecutionError extends RuntimeeError {
+export declare class ExecutionError extends BrninpayError {
     constructor(code: string, message: string, details?: unknown, options?: ErrorOptions);
 }
 export declare class NetworkError extends ExecutionError {
@@ -72,9 +72,9 @@ export declare class ReorgDetectedError extends ExecutionError {
     readonly depth: number;
     constructor(depth: number, options?: ErrorOptions);
 }
-export declare class HmacVerificationError extends RuntimeeError {
+export declare class HmacVerificationError extends BrninpayError {
     constructor(message: string, details?: unknown, options?: ErrorOptions);
 }
-export declare function isRuntimeeError(error: unknown): error is RuntimeeError;
+export declare function isBrninpayError(error: unknown): error is BrninpayError;
 export declare function serializeError(error: unknown): SerializedError;
 //# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.js

@@ -13,7 +13,7 @@ export var ErrorCode;
     ErrorCode["REORG_DETECTED"] = "reorg_detected";
     ErrorCode["HMAC_VERIFICATION_FAILED"] = "hmac_verification_failed";
 })(ErrorCode || (ErrorCode = {}));
-export class RuntimeeError extends Error {
+export class BrninpayError extends Error {
     code;
     statusCode;
     details;
@@ -29,12 +29,12 @@ export class RuntimeeError extends Error {
         return serializeError(this);
     }
 }
-export class ValidationError extends RuntimeeError {
+export class ValidationError extends BrninpayError {
     constructor(message, details, options) {
         super(ErrorCode.VALIDATION_ERROR, message, 400, details, options);
     }
 }
-export class AuthorizationError extends RuntimeeError {
+export class AuthorizationError extends BrninpayError {
     constructor(code, message, details, options) {
         super(code, message, 403, details, options);
     }
@@ -86,7 +86,7 @@ export class AuthorizationExpiredError extends AuthorizationError {
         super(ErrorCode.AUTHORIZATION_EXPIRED, 'Authorization preview has expired. Re-simulate.', undefined, options);
     }
 }
-export class ExecutionError extends RuntimeeError {
+export class ExecutionError extends BrninpayError {
     constructor(code, message, details, options) {
         super(code, message, 502, details, options);
     }
@@ -113,16 +113,16 @@ export class ReorgDetectedError extends ExecutionError {
         this.depth = depth;
     }
 }
-export class HmacVerificationError extends RuntimeeError {
+export class HmacVerificationError extends BrninpayError {
     constructor(message, details, options) {
         super(ErrorCode.HMAC_VERIFICATION_FAILED, message, 401, details, options);
     }
 }
-export function isRuntimeeError(error) {
-    return error instanceof RuntimeeError;
+export function isBrninpayError(error) {
+    return error instanceof BrninpayError;
 }
 export function serializeError(error) {
-    if (error instanceof RuntimeeError) {
+    if (error instanceof BrninpayError) {
         return {
             name: error.name,
             code: error.code,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brninpay/core",
-  "version": "0.1.0",
+  "version": "1.1.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/errors.ts

@@ -1,6 +1,6 @@
 export {
   ErrorCode,
-  RuntimeeError,
+  BrninpayError,
   ValidationError,
   AuthorizationError,
   BudgetExhaustedError,
@@ -13,7 +13,7 @@ export {
   BroadcastError,
   ReorgDetectedError,
   HmacVerificationError,
-  isRuntimeeError,
+  isBrninpayError,
   serializeError,
 } from './types/errors.js'
 

package/src/index.ts

@@ -53,7 +53,7 @@ export {
   AllowlistDeniedError,
   RateLimitExceededError,
   AuthorizationExpiredError,
-  RuntimeeError,
+  BrninpayError,
   ValidationError,
   ExecutionError,
   NetworkError,
@@ -61,7 +61,7 @@ export {
   BroadcastError,
   ReorgDetectedError,
   HmacVerificationError,
-  isRuntimeeError,
+  isBrninpayError,
   serializeError,
   ErrorCode,
 } from './errors.js'

package/src/types/errors.ts

@@ -26,7 +26,7 @@ export interface SerializedError {
   details?: unknown
 }
 
-export class RuntimeeError extends Error {
+export class BrninpayError extends Error {
   public readonly code: string
   public readonly statusCode: number
   public readonly details?: unknown
@@ -51,13 +51,13 @@ export class RuntimeeError extends Error {
   }
 }
 
-export class ValidationError extends RuntimeeError {
+export class ValidationError extends BrninpayError {
   constructor(message: string, details?: unknown, options?: ErrorOptions) {
     super(ErrorCode.VALIDATION_ERROR, message, 400, details, options)
   }
 }
 
-export class AuthorizationError extends RuntimeeError {
+export class AuthorizationError extends BrninpayError {
   constructor(code: string, message: string, details?: unknown, options?: ErrorOptions) {
     super(code, message, 403, details, options)
   }
@@ -137,7 +137,7 @@ export class AuthorizationExpiredError extends AuthorizationError {
   }
 }
 
-export class ExecutionError extends RuntimeeError {
+export class ExecutionError extends BrninpayError {
   constructor(code: string, message: string, details?: unknown, options?: ErrorOptions) {
     super(code, message, 502, details, options)
   }
@@ -175,18 +175,18 @@ export class ReorgDetectedError extends ExecutionError {
   }
 }
 
-export class HmacVerificationError extends RuntimeeError {
+export class HmacVerificationError extends BrninpayError {
   constructor(message: string, details?: unknown, options?: ErrorOptions) {
     super(ErrorCode.HMAC_VERIFICATION_FAILED, message, 401, details, options)
   }
 }
 
-export function isRuntimeeError(error: unknown): error is RuntimeeError {
-  return error instanceof RuntimeeError
+export function isBrninpayError(error: unknown): error is BrninpayError {
+  return error instanceof BrninpayError
 }
 
 export function serializeError(error: unknown): SerializedError {
-  if (error instanceof RuntimeeError) {
+  if (error instanceof BrninpayError) {
     return {
       name: error.name,
       code: error.code,