@kya-os/contracts 1.3.2 → 1.3.4

package/dist/tlkrc/rotation.js

@@ -1,127 +0,0 @@
-"use strict";
-/**
- * TLKRC (Transparent Log Key Rotation Contract)
- *
- * Types for key rotation events in a transparent, auditable manner
- *
- * Related Spec: MCP-I Core
- * Python Reference: Core-Documentation.md
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_GRACE_PERIOD_SEC = exports.DEFAULT_GRACE_PERIOD_SEC = exports.RotationChainSchema = exports.RotationEventSchema = void 0;
-exports.validateRotationEvent = validateRotationEvent;
-exports.isRotationChainValid = isRotationChainValid;
-exports.getActiveKeyAt = getActiveKeyAt;
-const zod_1 = require("zod");
-/**
- * Rotation Event Schema
- *
- * Represents a key rotation event in a transparent log.
- * Events form a hash-linked chain for auditability.
- *
- * **Dual-Key Grace Window:**
- * During rotation, both `prevKeyId` and `nextKeyId` are valid
- * from `effectiveAt` until `effectiveAt + grace period`.
- */
-exports.RotationEventSchema = zod_1.z.object({
-    /** DID of the issuer performing the rotation */
-    issuerDid: zod_1.z.string().min(1),
-    /** Previous key ID being rotated out */
-    prevKeyId: zod_1.z.string().min(1),
-    /** New key ID being rotated in */
-    nextKeyId: zod_1.z.string().min(1),
-    /** Timestamp when new key becomes effective (Unix seconds) */
-    effectiveAt: zod_1.z.number().int().positive(),
-    /** Timestamp when event was issued (Unix seconds) */
-    issuedAt: zod_1.z.number().int().positive(),
-    /** Sequence number (monotonically increasing) */
-    seq: zod_1.z.number().int().nonnegative(),
-    /** Hash of previous rotation event (null for first rotation) */
-    prevEventHash: zod_1.z.string().optional(),
-    /** Signature over the event (using prevKeyId) */
-    signature: zod_1.z.string().min(1),
-    /** Optional metadata */
-    metadata: zod_1.z.record(zod_1.z.any()).optional(),
-}).refine((event) => event.effectiveAt >= event.issuedAt, {
-    message: 'effectiveAt must be >= issuedAt',
-});
-/**
- * Rotation Chain
- *
- * Represents a chain of rotation events
- */
-exports.RotationChainSchema = zod_1.z.object({
-    /** Issuer DID */
-    issuerDid: zod_1.z.string().min(1),
-    /** All rotation events in order */
-    events: zod_1.z.array(exports.RotationEventSchema).min(1),
-    /** Current active key ID */
-    currentKeyId: zod_1.z.string().min(1),
-    /** Whether chain is valid */
-    valid: zod_1.z.boolean(),
-    /** Optional validation errors */
-    errors: zod_1.z.array(zod_1.z.string()).optional(),
-});
-/**
- * Validation Helpers
- */
-/**
- * Validate a rotation event
- *
- * @param event - The event to validate
- * @returns Validation result
- */
-function validateRotationEvent(event) {
-    return exports.RotationEventSchema.safeParse(event);
-}
-/**
- * Validate rotation chain integrity
- *
- * @param chain - The chain to validate
- * @returns true if chain is valid
- */
-function isRotationChainValid(chain) {
-    if (chain.events.length === 0) {
-        return false;
-    }
-    // Check sequence numbers are monotonic
-    for (let i = 1; i < chain.events.length; i++) {
-        if (chain.events[i].seq <= chain.events[i - 1].seq) {
-            return false;
-        }
-    }
-    return chain.valid;
-}
-/**
- * Get active key at a specific timestamp
- *
- * @param chain - The rotation chain
- * @param timestamp - Timestamp in seconds
- * @returns Active key ID at that time, or null if none
- */
-function getActiveKeyAt(chain, timestamp) {
-    if (chain.events.length === 0) {
-        return null;
-    }
-    // Find the most recent event that's effective at the timestamp
-    for (let i = chain.events.length - 1; i >= 0; i--) {
-        const event = chain.events[i];
-        if (event.effectiveAt <= timestamp) {
-            return event.nextKeyId;
-        }
-    }
-    // If no event is effective yet, use the initial key
-    return chain.events[0].prevKeyId;
-}
-/**
- * Constants
- */
-/**
- * Default grace period for dual-key validity (24 hours)
- */
-exports.DEFAULT_GRACE_PERIOD_SEC = 24 * 60 * 60;
-/**
- * Maximum reasonable grace period (30 days)
- */
-exports.MAX_GRACE_PERIOD_SEC = 30 * 24 * 60 * 60;
-//# sourceMappingURL=rotation.js.map

package/dist/utils/validation.d.ts

@@ -1,31 +0,0 @@
-/**
- * Shared validation utilities for mcpi packages
- * Consolidates common validation patterns to follow DRY principles
- */
-import { z } from "zod";
-/**
- * Generic validation result type
- */
-export interface ValidationResult<T = any> {
-    valid: boolean;
-    data?: T;
-    errors: string[];
-}
-/**
- * Generic validation function with helpful error messages
- */
-export declare function validateInput<T>(schema: z.ZodSchema<T>, data: unknown, context?: string): ValidationResult<T>;
-/**
- * Validate object has required properties
- */
-export declare function hasRequiredProperties(obj: any, properties: string[], context?: string): ValidationResult;
-/**
- * Validate string format patterns
- */
-export declare const StringValidators: {
-    did: (value: string) => boolean;
-    kid: (value: string) => boolean;
-    url: (value: string) => boolean;
-    projectName: (value: string) => boolean;
-};
-//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.js

@@ -1,70 +0,0 @@
-"use strict";
-/**
- * Shared validation utilities for mcpi packages
- * Consolidates common validation patterns to follow DRY principles
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StringValidators = void 0;
-exports.validateInput = validateInput;
-exports.hasRequiredProperties = hasRequiredProperties;
-/**
- * Generic validation function with helpful error messages
- */
-function validateInput(schema, data, context) {
-    const result = schema.safeParse(data);
-    if (result.success) {
-        return {
-            valid: true,
-            data: result.data,
-            errors: [],
-        };
-    }
-    const errors = result.error.errors.map((err) => {
-        const path = err.path.length > 0 ? ` at ${err.path.join(".")}` : "";
-        const contextStr = context ? ` (${context})` : "";
-        return `${err.message}${path}${contextStr}`;
-    });
-    return {
-        valid: false,
-        errors,
-    };
-}
-/**
- * Validate object has required properties
- */
-function hasRequiredProperties(obj, properties, context) {
-    if (typeof obj !== "object" || obj === null) {
-        return {
-            valid: false,
-            errors: [`Expected object${context ? ` for ${context}` : ""}`],
-        };
-    }
-    const missing = properties.filter((prop) => !(prop in obj));
-    if (missing.length > 0) {
-        return {
-            valid: false,
-            errors: [
-                `Missing required properties: ${missing.join(", ")}${context ? ` in ${context}` : ""}`,
-            ],
-        };
-    }
-    return { valid: true, errors: [] };
-}
-/**
- * Validate string format patterns
- */
-exports.StringValidators = {
-    did: (value) => /^did:[a-z0-9]+:[a-zA-Z0-9._-]+$/.test(value),
-    kid: (value) => /^[a-zA-Z0-9._-]+$/.test(value),
-    url: (value) => {
-        try {
-            new URL(value);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    },
-    projectName: (value) => /^[a-z0-9-]+$/.test(value) && value.length >= 1 && value.length <= 214,
-};
-//# sourceMappingURL=validation.js.map

package/dist/vc/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Verifiable Credentials Module Exports
- *
- * W3C Verifiable Credentials types, schemas, and utilities
- */
-export * from './schemas.js';
-export * from './statuslist.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/vc/index.js

@@ -1,24 +0,0 @@
-"use strict";
-/**
- * Verifiable Credentials Module Exports
- *
- * W3C Verifiable Credentials types, schemas, and utilities
- */
-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("./schemas.js"), exports);
-__exportStar(require("./statuslist.js"), exports);
-//# sourceMappingURL=index.js.map