@brninpay/core 0.1.0

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"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"}

package/dist/types/errors.js

@@ -0,0 +1,150 @@
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["VALIDATION_ERROR"] = "validation_error";
+    ErrorCode["AUTHORIZATION_ERROR"] = "authorization_error";
+    ErrorCode["BUDGET_EXHAUSTED"] = "budget_exhausted";
+    ErrorCode["ALLOWLIST_DENIED"] = "allowlist_denied";
+    ErrorCode["RATE_LIMIT_EXCEEDED"] = "rate_limit_exceeded";
+    ErrorCode["AUTHORIZATION_EXPIRED"] = "authorization_expired";
+    ErrorCode["EXECUTION_ERROR"] = "execution_error";
+    ErrorCode["NETWORK_ERROR"] = "network_error";
+    ErrorCode["GAS_ESTIMATION_ERROR"] = "gas_estimation_error";
+    ErrorCode["BROADCAST_ERROR"] = "broadcast_error";
+    ErrorCode["REORG_DETECTED"] = "reorg_detected";
+    ErrorCode["HMAC_VERIFICATION_FAILED"] = "hmac_verification_failed";
+})(ErrorCode || (ErrorCode = {}));
+export class RuntimeeError extends Error {
+    code;
+    statusCode;
+    details;
+    constructor(code, message, statusCode = 500, details, options) {
+        super(message, options);
+        this.name = new.target.name;
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return serializeError(this);
+    }
+}
+export class ValidationError extends RuntimeeError {
+    constructor(message, details, options) {
+        super(ErrorCode.VALIDATION_ERROR, message, 400, details, options);
+    }
+}
+export class AuthorizationError extends RuntimeeError {
+    constructor(code, message, details, options) {
+        super(code, message, 403, details, options);
+    }
+}
+export class BudgetExhaustedError extends AuthorizationError {
+    policyId;
+    budgetUsed;
+    budgetLimit;
+    constructor(policyId, used, limit, options) {
+        super(ErrorCode.BUDGET_EXHAUSTED, `Budget exhausted: ${used} used of ${limit} limit`, {
+            policyId,
+            budgetUsed: used.toString(),
+            budgetLimit: limit.toString(),
+        }, options);
+        this.policyId = policyId;
+        this.budgetUsed = used;
+        this.budgetLimit = limit;
+    }
+}
+export class AllowlistDeniedError extends AuthorizationError {
+    policyId;
+    target;
+    constructor(policyId, target, options) {
+        super(ErrorCode.ALLOWLIST_DENIED, `Target "${target}" not in allowlist`, {
+            policyId,
+            target,
+        }, options);
+        this.policyId = policyId;
+        this.target = target;
+    }
+}
+export class RateLimitExceededError extends AuthorizationError {
+    policyId;
+    windowMs;
+    maxCalls;
+    constructor(policyId, windowMs, maxCalls, options) {
+        super(ErrorCode.RATE_LIMIT_EXCEEDED, `Rate limit exceeded: max ${maxCalls} calls per ${windowMs}ms window`, {
+            policyId,
+            windowMs,
+            maxCalls,
+        }, options);
+        this.policyId = policyId;
+        this.windowMs = windowMs;
+        this.maxCalls = maxCalls;
+    }
+}
+export class AuthorizationExpiredError extends AuthorizationError {
+    constructor(options) {
+        super(ErrorCode.AUTHORIZATION_EXPIRED, 'Authorization preview has expired. Re-simulate.', undefined, options);
+    }
+}
+export class ExecutionError extends RuntimeeError {
+    constructor(code, message, details, options) {
+        super(code, message, 502, details, options);
+    }
+}
+export class NetworkError extends ExecutionError {
+    constructor(message, details, options) {
+        super(ErrorCode.NETWORK_ERROR, message, details, options);
+    }
+}
+export class GasEstimationError extends ExecutionError {
+    constructor(message, details, options) {
+        super(ErrorCode.GAS_ESTIMATION_ERROR, message, details, options);
+    }
+}
+export class BroadcastError extends ExecutionError {
+    constructor(message, details, options) {
+        super(ErrorCode.BROADCAST_ERROR, message, details, options);
+    }
+}
+export class ReorgDetectedError extends ExecutionError {
+    depth;
+    constructor(depth, options) {
+        super(ErrorCode.REORG_DETECTED, `Chain reorg detected at depth ${depth}`, { depth }, options);
+        this.depth = depth;
+    }
+}
+export class HmacVerificationError extends RuntimeeError {
+    constructor(message, details, options) {
+        super(ErrorCode.HMAC_VERIFICATION_FAILED, message, 401, details, options);
+    }
+}
+export function isRuntimeeError(error) {
+    return error instanceof RuntimeeError;
+}
+export function serializeError(error) {
+    if (error instanceof RuntimeeError) {
+        return {
+            name: error.name,
+            code: error.code,
+            message: error.message,
+            statusCode: error.statusCode,
+            details: error.details,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            code: ErrorCode.EXECUTION_ERROR,
+            message: error.message,
+            statusCode: 500,
+        };
+    }
+    return {
+        name: 'UnknownError',
+        code: ErrorCode.EXECUTION_ERROR,
+        message: 'Unknown error',
+        statusCode: 500,
+        details: error,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"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"}

package/dist/types/payment.d.ts

@@ -0,0 +1,55 @@
+import type { Address } from './wallet.js';
+export declare const PAYMENT_INTENT_STATUSES: readonly ["draft", "pending_policy", "pending_approval", "approved", "rejected", "pending_submission", "submitted", "confirming", "succeeded", "failed", "cancelled", "expired"];
+export type PaymentIntentStatus = (typeof PAYMENT_INTENT_STATUSES)[number];
+export interface PaymentAmount {
+    currency: 'USDC';
+    value: bigint;
+    decimals: number;
+}
+export interface PaymentRecipient {
+    address: Address;
+    chainId: number;
+    ensName?: string | null;
+}
+export interface PaymentIntentFailure {
+    code: string;
+    message: string;
+    retryable: boolean;
+    detail?: Record<string, unknown>;
+}
+export type PaymentMetadataValue = string | number | boolean | null | PaymentMetadataValue[] | {
+    [key: string]: PaymentMetadataValue;
+};
+export interface PaymentIntent {
+    id: string;
+    workspaceId: string;
+    actorId: string;
+    status: PaymentIntentStatus;
+    amount: PaymentAmount;
+    recipient: PaymentRecipient;
+    createdAt: string;
+    updatedAt: string;
+    expiresAt?: string | null;
+    idempotencyKey?: string | null;
+    description?: string | null;
+    reference?: string | null;
+    transactionHash?: `0x${string}` | null;
+    failure?: PaymentIntentFailure | null;
+    metadata?: Record<string, PaymentMetadataValue>;
+}
+export interface SerializedBigInt {
+    __type: 'bigint';
+    value: string;
+}
+export declare const PAYMENT_INTENT_TERMINAL_STATUSES: Set<"draft" | "pending_policy" | "pending_approval" | "approved" | "rejected" | "pending_submission" | "submitted" | "confirming" | "succeeded" | "failed" | "cancelled" | "expired">;
+export declare const PAYMENT_INTENT_TRANSITIONS: Record<PaymentIntentStatus, readonly PaymentIntentStatus[]>;
+export declare function validatePaymentAmount(amount: PaymentAmount): void;
+export declare function isPaymentIntentTerminalStatus(status: PaymentIntentStatus): boolean;
+export declare function canTransitionPaymentIntentStatus(currentStatus: PaymentIntentStatus, nextStatus: PaymentIntentStatus): boolean;
+export declare function assertValidPaymentIntentTransition(currentStatus: PaymentIntentStatus, nextStatus: PaymentIntentStatus): void;
+export declare function assertPaymentIntent(value: unknown): asserts value is PaymentIntent;
+export declare function serializeBigInts(value: unknown): unknown;
+export declare function deserializeBigInts<T>(value: unknown): T;
+export declare function serializePaymentIntent(paymentIntent: PaymentIntent): string;
+export declare function deserializePaymentIntent(payload: string | unknown): PaymentIntent;
+//# sourceMappingURL=payment.d.ts.map

package/dist/types/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../src/types/payment.ts"],"names":[],"mappings":"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"}

package/dist/types/payment.js

@@ -0,0 +1,188 @@
+import { ValidationError } from './errors.js';
+export const PAYMENT_INTENT_STATUSES = [
+    'draft',
+    'pending_policy',
+    'pending_approval',
+    'approved',
+    'rejected',
+    'pending_submission',
+    'submitted',
+    'confirming',
+    'succeeded',
+    'failed',
+    'cancelled',
+    'expired',
+];
+export const PAYMENT_INTENT_TERMINAL_STATUSES = new Set([
+    'rejected',
+    'succeeded',
+    'failed',
+    'cancelled',
+    'expired',
+]);
+export const PAYMENT_INTENT_TRANSITIONS = {
+    draft: ['pending_policy', 'cancelled', 'expired'],
+    pending_policy: ['pending_approval', 'approved', 'rejected', 'cancelled', 'expired'],
+    pending_approval: ['approved', 'rejected', 'cancelled', 'expired'],
+    approved: ['pending_submission', 'submitted', 'cancelled', 'expired'],
+    rejected: [],
+    pending_submission: ['submitted', 'failed', 'cancelled', 'expired'],
+    submitted: ['confirming', 'succeeded', 'failed'],
+    confirming: ['succeeded', 'failed'],
+    succeeded: [],
+    failed: [],
+    cancelled: [],
+    expired: [],
+};
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function assertIsoTimestamp(value, fieldName) {
+    if (Number.isNaN(Date.parse(value))) {
+        throw new ValidationError(`${fieldName} must be a valid ISO-8601 timestamp`, {
+            field: fieldName,
+            value,
+        });
+    }
+}
+export function validatePaymentAmount(amount) {
+    if (amount.currency !== 'USDC') {
+        throw new ValidationError('Payment amount currency must be USDC', {
+            field: 'amount.currency',
+            value: amount.currency,
+        });
+    }
+    if (amount.value <= 0n) {
+        throw new ValidationError('Payment amount must be greater than zero', {
+            field: 'amount.value',
+            value: amount.value.toString(),
+        });
+    }
+    if (!Number.isInteger(amount.decimals) || amount.decimals < 0 || amount.decimals > 18) {
+        throw new ValidationError('Payment amount decimals must be an integer between 0 and 18', {
+            field: 'amount.decimals',
+            value: amount.decimals,
+        });
+    }
+}
+export function isPaymentIntentTerminalStatus(status) {
+    return PAYMENT_INTENT_TERMINAL_STATUSES.has(status);
+}
+export function canTransitionPaymentIntentStatus(currentStatus, nextStatus) {
+    return PAYMENT_INTENT_TRANSITIONS[currentStatus].includes(nextStatus);
+}
+export function assertValidPaymentIntentTransition(currentStatus, nextStatus) {
+    if (!canTransitionPaymentIntentStatus(currentStatus, nextStatus)) {
+        throw new ValidationError(`Invalid payment intent transition from ${currentStatus} to ${nextStatus}`, {
+            currentStatus,
+            nextStatus,
+        });
+    }
+}
+export function assertPaymentIntent(value) {
+    if (!isObject(value)) {
+        throw new ValidationError('Payment intent payload must be an object');
+    }
+    if (typeof value.id !== 'string' || !value.id.trim()) {
+        throw new ValidationError('Payment intent id is required', { field: 'id' });
+    }
+    if (typeof value.workspaceId !== 'string' || !value.workspaceId.trim()) {
+        throw new ValidationError('Payment intent workspaceId is required', {
+            field: 'workspaceId',
+        });
+    }
+    if (typeof value.actorId !== 'string' || !value.actorId.trim()) {
+        throw new ValidationError('Payment intent actorId is required', {
+            field: 'actorId',
+        });
+    }
+    if (typeof value.status !== 'string' ||
+        !PAYMENT_INTENT_STATUSES.includes(value.status)) {
+        throw new ValidationError('Payment intent status is invalid', {
+            field: 'status',
+            value: value.status,
+        });
+    }
+    if (!isObject(value.amount)) {
+        throw new ValidationError('Payment intent amount is required', { field: 'amount' });
+    }
+    if (!isObject(value.recipient)) {
+        throw new ValidationError('Payment intent recipient is required', {
+            field: 'recipient',
+        });
+    }
+    if (typeof value.recipient.address !== 'string' || !value.recipient.address.startsWith('0x')) {
+        throw new ValidationError('Payment intent recipient address is invalid', {
+            field: 'recipient.address',
+            value: value.recipient.address,
+        });
+    }
+    if (typeof value.recipient.chainId !== 'number' ||
+        !Number.isInteger(value.recipient.chainId) ||
+        value.recipient.chainId <= 0) {
+        throw new ValidationError('Payment intent recipient chainId is invalid', {
+            field: 'recipient.chainId',
+            value: value.recipient.chainId,
+        });
+    }
+    validatePaymentAmount(value.amount);
+    if (typeof value.createdAt !== 'string') {
+        throw new ValidationError('Payment intent createdAt is required', {
+            field: 'createdAt',
+        });
+    }
+    if (typeof value.updatedAt !== 'string') {
+        throw new ValidationError('Payment intent updatedAt is required', {
+            field: 'updatedAt',
+        });
+    }
+    assertIsoTimestamp(value.createdAt, 'createdAt');
+    assertIsoTimestamp(value.updatedAt, 'updatedAt');
+    if (value.expiresAt !== undefined && value.expiresAt !== null && typeof value.expiresAt !== 'string') {
+        throw new ValidationError('Payment intent expiresAt must be a timestamp string', {
+            field: 'expiresAt',
+        });
+    }
+    if (value.expiresAt) {
+        assertIsoTimestamp(value.expiresAt, 'expiresAt');
+    }
+}
+export function serializeBigInts(value) {
+    if (typeof value === 'bigint') {
+        return {
+            __type: 'bigint',
+            value: value.toString(),
+        };
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => serializeBigInts(entry));
+    }
+    if (isObject(value)) {
+        return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, serializeBigInts(entry)]));
+    }
+    return value;
+}
+export function deserializeBigInts(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => deserializeBigInts(entry));
+    }
+    if (isObject(value)) {
+        if (value.__type === 'bigint' && typeof value.value === 'string') {
+            return BigInt(value.value);
+        }
+        return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, deserializeBigInts(entry)]));
+    }
+    return value;
+}
+export function serializePaymentIntent(paymentIntent) {
+    assertPaymentIntent(paymentIntent);
+    // Preserve bigint fidelity over JSON transport without leaking decimal precision.
+    return JSON.stringify(serializeBigInts(paymentIntent));
+}
+export function deserializePaymentIntent(payload) {
+    const candidate = typeof payload === 'string' ? JSON.parse(payload) : payload;
+    const paymentIntent = deserializeBigInts(candidate);
+    assertPaymentIntent(paymentIntent);
+    return paymentIntent;
+}
+//# sourceMappingURL=payment.js.map

package/dist/types/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../src/types/payment.ts"],"names":[],"mappings":"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"}

package/dist/types/policy.d.ts

@@ -0,0 +1,58 @@
+import type { Address } from './wallet.js';
+export declare const POLICY_DECISIONS: readonly ["allow", "deny", "review"];
+export type PolicyDecision = (typeof POLICY_DECISIONS)[number];
+export interface PolicyReason {
+    code: string;
+    message: string;
+    detail?: Record<string, unknown>;
+}
+export interface BasePolicy {
+    id: string;
+    name: string;
+    enabled: boolean;
+}
+export interface BudgetPolicy extends BasePolicy {
+    kind: 'budget';
+    currency: 'USDC';
+    limit: bigint;
+    softLimit?: bigint;
+}
+export interface AllowlistPolicy extends BasePolicy {
+    kind: 'allowlist';
+    addresses: readonly Address[];
+    chains?: readonly number[];
+}
+export interface RateLimitPolicy extends BasePolicy {
+    kind: 'rate_limit';
+    maxRequests: number;
+    intervalMs: number;
+    burst?: number;
+    scope: 'actor' | 'workspace' | 'ip';
+}
+export type PolicyDefinition = BudgetPolicy | AllowlistPolicy | RateLimitPolicy;
+export interface PolicyEvaluationContext {
+    actorId: string;
+    workspaceId: string;
+    recipient: Address;
+    chainId: number;
+    amount: bigint;
+    currency: 'USDC';
+    timestampMs: number;
+    spentAmount: bigint;
+    requestCount: number;
+    sourceIp?: string;
+}
+export interface PolicyEvaluationResult {
+    policyId: string;
+    decision: PolicyDecision;
+    reason: PolicyReason;
+}
+export interface AggregatedPolicyDecision {
+    decision: PolicyDecision;
+    reasons: PolicyReason[];
+    evaluations: PolicyEvaluationResult[];
+}
+export declare function evaluatePolicy(policy: PolicyDefinition, context: PolicyEvaluationContext): PolicyEvaluationResult;
+export declare function aggregatePolicyDecisions(evaluations: readonly PolicyEvaluationResult[]): AggregatedPolicyDecision;
+export declare function evaluatePolicies(policies: readonly PolicyDefinition[], context: PolicyEvaluationContext): AggregatedPolicyDecision;
+//# sourceMappingURL=policy.d.ts.map

package/dist/types/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/types/policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,eAAO,MAAM,gBAAgB,sCAAuC,CAAA;AAEpE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,IAAI,EAAE,QAAQ,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE,SAAS,OAAO,EAAE,CAAA;IAC7B,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAAA;CACpC;AAED,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,eAAe,GAAG,eAAe,CAAA;AAE/E,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAA;IACxB,MAAM,EAAE,YAAY,CAAA;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,cAAc,CAAA;IACxB,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,WAAW,EAAE,sBAAsB,EAAE,CAAA;CACtC;AAgBD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,uBAAuB,GAC/B,sBAAsB,CAmKxB;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,SAAS,sBAAsB,EAAE,GAC7C,wBAAwB,CA4B1B;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,OAAO,EAAE,uBAAuB,GAC/B,wBAAwB,CAI1B"}