@kya-os/contracts 1.2.1 → 1.3.0

package/dist/delegation/schemas.d.ts.map

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

package/dist/delegation/schemas.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Delegation Record Schemas
+ *
+ * Types and schemas for delegation records that link VCs with CRISP constraints.
+ * Delegations represent the transfer of authority from one DID to another.
+ *
+ * Related Spec: MCP-I §4.1, §4.2
+ * Python Reference: Delegation-Documentation.md, Delegation-Service.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DELEGATION_STATUSES = exports.DEFAULT_DELEGATION_STATUS = exports.MAX_DELEGATION_CHAIN_DEPTH = exports.DelegationVerificationResultSchema = exports.DelegationCreationRequestSchema = exports.DelegationChainSchema = exports.DelegationChainEntrySchema = exports.DelegationRecordSchema = exports.DelegationStatusSchema = void 0;
+exports.validateDelegationRecord = validateDelegationRecord;
+exports.validateDelegationChain = validateDelegationChain;
+exports.isDelegationExpired = isDelegationExpired;
+exports.isDelegationNotYetValid = isDelegationNotYetValid;
+exports.isDelegationCurrentlyValid = isDelegationCurrentlyValid;
+const zod_1 = require("zod");
+const constraints_js_1 = require("./constraints.js");
+/**
+ * Delegation Status
+ *
+ * Lifecycle status of a delegation
+ */
+exports.DelegationStatusSchema = zod_1.z.enum(['active', 'revoked', 'expired']);
+/**
+ * Delegation Record Schema
+ *
+ * Complete delegation record linking issuer (delegator) to subject (delegatee)
+ * with backing VC and CRISP constraints.
+ *
+ * **Key Invariants:**
+ * - Delegation MUST reference a live VC via `vcId`
+ * - Revocation of VC invalidates all linked delegations
+ * - Chain: no cycles allowed
+ * - Child `notAfter` ≤ parent `notAfter`
+ * - Child scopes ⊆ parent scopes
+ * - Child budgets ≤ parent budgets (same unit)
+ */
+exports.DelegationRecordSchema = zod_1.z.object({
+    /** Unique identifier for the delegation */
+    id: zod_1.z.string().min(1),
+    /** DID of the delegator (issuer, e.g., merchant/user) */
+    issuerDid: zod_1.z.string().min(1),
+    /** DID of the delegatee (subject, e.g., agent) */
+    subjectDid: zod_1.z.string().min(1),
+    /** Optional controller (user account ID or DID) */
+    controller: zod_1.z.string().optional(),
+    /** ID of the backing Verifiable Credential */
+    vcId: zod_1.z.string().min(1),
+    /** Optional parent delegation ID for chain tracking */
+    parentId: zod_1.z.string().optional(),
+    /** CRISP constraints on this delegation */
+    constraints: constraints_js_1.DelegationConstraintsSchema,
+    /** Detached JWS signature over canonical delegation document */
+    signature: zod_1.z.string().min(1),
+    /** Current status of the delegation */
+    status: exports.DelegationStatusSchema,
+    /** Timestamp when created (milliseconds since epoch) */
+    createdAt: zod_1.z.number().int().positive().optional(),
+    /** Timestamp when revoked (if status is revoked) */
+    revokedAt: zod_1.z.number().int().positive().optional(),
+    /** Optional reason for revocation */
+    revokedReason: zod_1.z.string().optional(),
+    /** Optional metadata */
+    metadata: zod_1.z.record(zod_1.z.any()).optional(),
+}).passthrough(); // Allow extensibility
+/**
+ * Delegation Chain Entry
+ *
+ * Represents a single link in a delegation chain
+ */
+exports.DelegationChainEntrySchema = zod_1.z.object({
+    /** Delegation ID */
+    delegationId: zod_1.z.string().min(1),
+    /** Issuer DID */
+    issuerDid: zod_1.z.string().min(1),
+    /** Subject DID */
+    subjectDid: zod_1.z.string().min(1),
+    /** VC ID */
+    vcId: zod_1.z.string().min(1),
+    /** Depth in chain (0 = root) */
+    depth: zod_1.z.number().int().nonnegative(),
+    /** Constraints */
+    constraints: constraints_js_1.DelegationConstraintsSchema,
+    /** Status */
+    status: exports.DelegationStatusSchema,
+});
+/**
+ * Delegation Chain
+ *
+ * Represents a complete delegation chain from root to leaf
+ */
+exports.DelegationChainSchema = zod_1.z.object({
+    /** Root issuer DID */
+    rootIssuer: zod_1.z.string().min(1),
+    /** Leaf subject DID */
+    leafSubject: zod_1.z.string().min(1),
+    /** All delegations in the chain, ordered root to leaf */
+    chain: zod_1.z.array(exports.DelegationChainEntrySchema).min(1),
+    /** Total chain depth */
+    depth: zod_1.z.number().int().nonnegative(),
+    /** Whether the entire chain is valid */
+    valid: zod_1.z.boolean(),
+    /** Optional validation errors */
+    errors: zod_1.z.array(zod_1.z.string()).optional(),
+});
+/**
+ * Delegation Creation Request
+ *
+ * Input for creating a new delegation
+ */
+exports.DelegationCreationRequestSchema = zod_1.z.object({
+    /** Delegator DID */
+    issuerDid: zod_1.z.string().min(1),
+    /** Delegatee DID */
+    subjectDid: zod_1.z.string().min(1),
+    /** Optional controller */
+    controller: zod_1.z.string().optional(),
+    /** Constraints */
+    constraints: constraints_js_1.DelegationConstraintsSchema,
+    /** Optional parent delegation ID */
+    parentId: zod_1.z.string().optional(),
+    /** Optional VC ID (if not provided, will be created) */
+    vcId: zod_1.z.string().optional(),
+});
+/**
+ * Delegation Verification Result
+ *
+ * Result of delegation verification
+ */
+exports.DelegationVerificationResultSchema = zod_1.z.object({
+    /** Whether delegation is valid */
+    valid: zod_1.z.boolean(),
+    /** Delegation ID */
+    delegationId: zod_1.z.string().min(1),
+    /** Status */
+    status: exports.DelegationStatusSchema,
+    /** Optional reason for invalid status */
+    reason: zod_1.z.string().optional(),
+    /** Whether backing VC is valid */
+    credentialValid: zod_1.z.boolean().optional(),
+    /** Whether chain is valid (if part of chain) */
+    chainValid: zod_1.z.boolean().optional(),
+    /** Timestamp of verification */
+    verifiedAt: zod_1.z.number().int().positive(),
+    /** Optional verification details */
+    details: zod_1.z.record(zod_1.z.any()).optional(),
+});
+/**
+ * Validation Helpers
+ */
+/**
+ * Validate a delegation record
+ *
+ * @param record - The delegation record to validate
+ * @returns Validation result
+ */
+function validateDelegationRecord(record) {
+    return exports.DelegationRecordSchema.safeParse(record);
+}
+/**
+ * Validate a delegation chain
+ *
+ * @param chain - The delegation chain to validate
+ * @returns Validation result
+ */
+function validateDelegationChain(chain) {
+    return exports.DelegationChainSchema.safeParse(chain);
+}
+/**
+ * Check if a delegation is expired based on constraints
+ *
+ * @param delegation - The delegation to check
+ * @returns true if expired
+ */
+function isDelegationExpired(delegation) {
+    if (!delegation.constraints.notAfter) {
+        return false;
+    }
+    const nowSec = Math.floor(Date.now() / 1000);
+    return nowSec > delegation.constraints.notAfter;
+}
+/**
+ * Check if a delegation is not yet valid based on constraints
+ *
+ * @param delegation - The delegation to check
+ * @returns true if not yet valid
+ */
+function isDelegationNotYetValid(delegation) {
+    if (!delegation.constraints.notBefore) {
+        return false;
+    }
+    const nowSec = Math.floor(Date.now() / 1000);
+    return nowSec < delegation.constraints.notBefore;
+}
+/**
+ * Check if a delegation is currently valid (active and within time bounds)
+ *
+ * @param delegation - The delegation to check
+ * @returns true if currently valid
+ */
+function isDelegationCurrentlyValid(delegation) {
+    if (delegation.status !== 'active') {
+        return false;
+    }
+    if (isDelegationExpired(delegation)) {
+        return false;
+    }
+    if (isDelegationNotYetValid(delegation)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Constants
+ */
+/**
+ * Maximum reasonable delegation chain depth
+ */
+exports.MAX_DELEGATION_CHAIN_DEPTH = 10;
+/**
+ * Default delegation status for new delegations
+ */
+exports.DEFAULT_DELEGATION_STATUS = 'active';
+/**
+ * Supported delegation statuses
+ */
+exports.DELEGATION_STATUSES = ['active', 'revoked', 'expired'];
+//# sourceMappingURL=schemas.js.map

package/dist/did/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * DID Module Exports
+ *
+ * Types and contracts for W3C Decentralized Identifiers (DIDs)
+ */
+export * from './types.js';
+export * from './resolve-contract.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/did/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/did/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC"}

package/dist/did/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * DID Module Exports
+ *
+ * Types and contracts for W3C Decentralized Identifiers (DIDs)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./resolve-contract.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/did/resolve-contract.d.ts

@@ -0,0 +1,220 @@
+/**
+ * DID Resolver Contract
+ *
+ * Interface contracts for DID resolution across different implementations.
+ * This file contains ONLY interfaces and types - no functional code.
+ *
+ * Related Spec: MCP-I §2.3
+ * Python Reference: DID-Service.md
+ */
+import type { DidDocument } from './types.js';
+/**
+ * Options for DID resolution
+ */
+export interface ResolveOptions {
+    /**
+     * Maximum time in milliseconds to wait for resolution
+     * Default: 500ms (as per env/constants.ts)
+     */
+    timeoutMs?: number;
+    /**
+     * Whether to accept cached resolution results
+     * If false, forces a fresh resolution
+     * Default: true
+     */
+    acceptCache?: boolean;
+    /**
+     * Desired cache TTL for this resolution in seconds
+     * Implementation may ignore if not applicable
+     */
+    cacheTtlSec?: number;
+    /**
+     * Additional metadata to pass to the resolver
+     * Used for method-specific resolution options
+     */
+    metadata?: Record<string, any>;
+}
+/**
+ * Result of DID resolution
+ *
+ * Contains the resolved DID Document and metadata about the resolution.
+ */
+export interface ResolveResult {
+    /**
+     * The resolved DID Document
+     */
+    doc: DidDocument;
+    /**
+     * Timestamp (milliseconds since epoch) when the document was fetched
+     */
+    fetchedAt: number;
+    /**
+     * Cache TTL in seconds (if applicable)
+     * Indicates how long this result may be cached
+     */
+    cacheTtlSec?: number;
+    /**
+     * Metadata about the resolution process
+     * May include method-specific information
+     */
+    metadata?: {
+        /** Source of the resolution (e.g., "cache", "network", "local") */
+        source?: string;
+        /** Method used for resolution */
+        method?: string;
+        /** Whether the document was retrieved from cache */
+        fromCache?: boolean;
+        /** Additional method-specific metadata */
+        [key: string]: any;
+    };
+}
+/**
+ * Resolution Error Details
+ *
+ * Structure for errors during DID resolution.
+ */
+export interface ResolutionError {
+    /** Error code (e.g., "notFound", "invalidDid", "methodNotSupported") */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** Original error if available */
+    cause?: Error;
+    /** Additional error details */
+    details?: Record<string, any>;
+}
+/**
+ * DID Resolver Interface
+ *
+ * Defines the contract for resolving DIDs to DID Documents.
+ * Implementations must handle different DID methods and provide caching.
+ *
+ * **Implementation Notes:**
+ * - Resolvers SHOULD support caching to improve performance
+ * - Resolvers MUST respect timeoutMs to prevent hanging
+ * - Resolvers MUST validate DID format before attempting resolution
+ * - Resolvers MAY support multiple DID methods via a registry pattern
+ *
+ * **Edge Compatibility:**
+ * Implementations intended for edge environments should:
+ * - Minimize dependencies
+ * - Support offline resolution where possible (e.g., did:key)
+ * - Use efficient caching strategies
+ * - Handle network failures gracefully
+ */
+export interface DidResolver {
+    /**
+     * Resolve a DID to its DID Document
+     *
+     * @param did - The DID to resolve (e.g., "did:key:z6Mk...")
+     * @param opts - Resolution options
+     * @returns Promise resolving to the DID Document and metadata
+     * @throws {ResolutionError} If resolution fails
+     */
+    resolve(did: string, opts?: ResolveOptions): Promise<ResolveResult>;
+}
+/**
+ * DID Method Resolver Interface
+ *
+ * Interface for method-specific resolvers.
+ * A universal resolver delegates to method resolvers based on the DID method.
+ */
+export interface DidMethodResolver {
+    /**
+     * The DID method this resolver handles (e.g., "key", "web")
+     */
+    readonly method: string;
+    /**
+     * Resolve a DID using this method
+     *
+     * @param did - The DID to resolve
+     * @param opts - Resolution options
+     * @returns Promise resolving to the DID Document and metadata
+     * @throws {ResolutionError} If resolution fails
+     */
+    resolve(did: string, opts?: ResolveOptions): Promise<ResolveResult>;
+    /**
+     * Check if this resolver supports the given DID
+     *
+     * @param did - The DID to check
+     * @returns true if this resolver can handle the DID
+     */
+    supports(did: string): boolean;
+}
+/**
+ * DID Resolution Cache Interface
+ *
+ * Interface for caching resolved DID Documents.
+ */
+export interface DidResolutionCache {
+    /**
+     * Get a cached resolution result
+     *
+     * @param did - The DID to look up
+     * @returns Promise resolving to cached result or null if not found/expired
+     */
+    get(did: string): Promise<ResolveResult | null>;
+    /**
+     * Store a resolution result in cache
+     *
+     * @param did - The DID being cached
+     * @param result - The resolution result
+     * @param ttlSec - TTL in seconds
+     * @returns Promise resolving when stored
+     */
+    set(did: string, result: ResolveResult, ttlSec: number): Promise<void>;
+    /**
+     * Invalidate cached result for a DID
+     *
+     * @param did - The DID to invalidate
+     * @returns Promise resolving when invalidated
+     */
+    invalidate(did: string): Promise<void>;
+    /**
+     * Clear all cached results
+     *
+     * @returns Promise resolving when cleared
+     */
+    clear(): Promise<void>;
+}
+/**
+ * Universal DID Resolver Configuration
+ *
+ * Configuration for a universal resolver that delegates to method-specific resolvers.
+ */
+export interface UniversalResolverConfig {
+    /**
+     * Method-specific resolvers
+     * Key is the method name (e.g., "key", "web")
+     */
+    methodResolvers?: Map<string, DidMethodResolver> | Record<string, DidMethodResolver>;
+    /**
+     * Optional cache implementation
+     */
+    cache?: DidResolutionCache;
+    /**
+     * Default resolution options
+     */
+    defaultOptions?: ResolveOptions;
+}
+/**
+ * Common resolution error codes
+ */
+export declare const RESOLUTION_ERROR_CODES: {
+    /** DID not found */
+    readonly NOT_FOUND: "notFound";
+    /** Invalid DID format */
+    readonly INVALID_DID: "invalidDid";
+    /** DID method not supported */
+    readonly METHOD_NOT_SUPPORTED: "methodNotSupported";
+    /** Resolution timeout */
+    readonly TIMEOUT: "timeout";
+    /** Network error during resolution */
+    readonly NETWORK_ERROR: "networkError";
+    /** Invalid DID Document structure */
+    readonly INVALID_DOCUMENT: "invalidDocument";
+    /** Internal resolver error */
+    readonly INTERNAL_ERROR: "internalError";
+};
+export type ResolutionErrorCode = (typeof RESOLUTION_ERROR_CODES)[keyof typeof RESOLUTION_ERROR_CODES];
+//# sourceMappingURL=resolve-contract.d.ts.map

package/dist/did/resolve-contract.d.ts.map

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

package/dist/did/resolve-contract.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * DID Resolver Contract
+ *
+ * Interface contracts for DID resolution across different implementations.
+ * This file contains ONLY interfaces and types - no functional code.
+ *
+ * Related Spec: MCP-I §2.3
+ * Python Reference: DID-Service.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESOLUTION_ERROR_CODES = void 0;
+/**
+ * Common resolution error codes
+ */
+exports.RESOLUTION_ERROR_CODES = {
+    /** DID not found */
+    NOT_FOUND: 'notFound',
+    /** Invalid DID format */
+    INVALID_DID: 'invalidDid',
+    /** DID method not supported */
+    METHOD_NOT_SUPPORTED: 'methodNotSupported',
+    /** Resolution timeout */
+    TIMEOUT: 'timeout',
+    /** Network error during resolution */
+    NETWORK_ERROR: 'networkError',
+    /** Invalid DID Document structure */
+    INVALID_DOCUMENT: 'invalidDocument',
+    /** Internal resolver error */
+    INTERNAL_ERROR: 'internalError',
+};
+//# sourceMappingURL=resolve-contract.js.map