@kya-os/contracts 1.2.1 → 1.2.2

package/dist/did/types.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * DID Document Types (W3C Compliant)
+ *
+ * These types conform to the W3C DID Core specification and provide
+ * TypeScript parity with the Python implementation.
+ *
+ * Related Spec: MCP-I §2.1, §2.3
+ * Python Reference: DID-Documentation.md, DID-Service.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isVerificationMethod = isVerificationMethod;
+exports.isVerificationMethodReference = isVerificationMethodReference;
+exports.isDidDocument = isDidDocument;
+exports.extractDidMethod = extractDidMethod;
+exports.extractKeyId = extractKeyId;
+/**
+ * Helper type guards
+ */
+/**
+ * Type guard to check if a value is a VerificationMethod
+ */
+function isVerificationMethod(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.id === 'string' &&
+        typeof value.type === 'string' &&
+        typeof value.controller === 'string');
+}
+/**
+ * Type guard to check if a value is a string reference to a verification method
+ */
+function isVerificationMethodReference(value) {
+    return typeof value === 'string';
+}
+/**
+ * Type guard to check if a DID Document is valid (basic structural check)
+ */
+function isDidDocument(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.id === 'string' &&
+        value.id.startsWith('did:'));
+}
+/**
+ * Extract DID method from a DID string
+ *
+ * @param did - The DID string (e.g., "did:key:z6Mk...")
+ * @returns The method name (e.g., "key") or null if invalid
+ */
+function extractDidMethod(did) {
+    const parts = did.split(':');
+    if (parts.length < 3 || parts[0] !== 'did') {
+        return null;
+    }
+    return parts[1];
+}
+/**
+ * Extract key ID from a DID URL
+ *
+ * @param didUrl - A DID URL with fragment (e.g., "did:key:z6Mk...#key-1")
+ * @returns The fragment part (e.g., "key-1") or null if no fragment
+ */
+function extractKeyId(didUrl) {
+    const hashIndex = didUrl.indexOf('#');
+    if (hashIndex === -1) {
+        return null;
+    }
+    return didUrl.substring(hashIndex + 1);
+}
+//# sourceMappingURL=types.js.map

package/dist/env/constants.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Environment Constants
+ *
+ * System-wide constants for algorithms, TTLs, and limits
+ *
+ * Related Spec: MCP-I §8
+ * Python Reference: All service documentation files
+ */
+/**
+ * Hash algorithm for cryptographic operations
+ */
+export declare const HASH_ALGO: "SHA-256";
+/**
+ * Supported signature algorithms
+ */
+export declare const SIG_ALGOS: readonly ["Ed25519", "ES256"];
+export type SignatureAlgorithm = (typeof SIG_ALGOS)[number];
+/**
+ * Nonce TTL in milliseconds (5 minutes)
+ */
+export declare const NONCE_TTL_MS: number;
+/**
+ * Resume token TTL in milliseconds (10 minutes)
+ */
+export declare const RESUME_TOKEN_TTL_MS: number;
+/**
+ * StatusList2021 cache TTL in seconds (1 minute)
+ */
+export declare const STATUSLIST_CACHE_SEC = 60;
+/**
+ * DID resolution timeout in milliseconds (500ms)
+ */
+export declare const DID_RESOLVE_TIMEOUT_MS = 500;
+/**
+ * Default session TTL in minutes (30 minutes)
+ */
+export declare const DEFAULT_SESSION_TTL_MINUTES = 30;
+/**
+ * Maximum timestamp skew in seconds (2 minutes)
+ */
+export declare const MAX_TIMESTAMP_SKEW_SEC = 120;
+/**
+ * Maximum delegation chain depth
+ */
+export declare const MAX_DELEGATION_CHAIN_DEPTH = 10;
+/**
+ * Maximum status list size (1 million entries)
+ */
+export declare const MAX_STATUSLIST_SIZE = 1000000;
+/**
+ * Proof archive TTL in seconds (30 days)
+ */
+export declare const PROOF_ARCHIVE_TTL_SEC: number;
+/**
+ * Key rotation grace period in seconds (24 hours)
+ */
+export declare const KEY_ROTATION_GRACE_PERIOD_SEC: number;
+//# sourceMappingURL=constants.d.ts.map

package/dist/env/constants.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Environment Constants
+ *
+ * System-wide constants for algorithms, TTLs, and limits
+ *
+ * Related Spec: MCP-I §8
+ * Python Reference: All service documentation files
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KEY_ROTATION_GRACE_PERIOD_SEC = exports.PROOF_ARCHIVE_TTL_SEC = exports.MAX_STATUSLIST_SIZE = exports.MAX_DELEGATION_CHAIN_DEPTH = exports.MAX_TIMESTAMP_SKEW_SEC = exports.DEFAULT_SESSION_TTL_MINUTES = exports.DID_RESOLVE_TIMEOUT_MS = exports.STATUSLIST_CACHE_SEC = exports.RESUME_TOKEN_TTL_MS = exports.NONCE_TTL_MS = exports.SIG_ALGOS = exports.HASH_ALGO = void 0;
+/**
+ * Hash algorithm for cryptographic operations
+ */
+exports.HASH_ALGO = 'SHA-256';
+/**
+ * Supported signature algorithms
+ */
+exports.SIG_ALGOS = ['Ed25519', 'ES256'];
+/**
+ * Nonce TTL in milliseconds (5 minutes)
+ */
+exports.NONCE_TTL_MS = 5 * 60 * 1000;
+/**
+ * Resume token TTL in milliseconds (10 minutes)
+ */
+exports.RESUME_TOKEN_TTL_MS = 10 * 60 * 1000;
+/**
+ * StatusList2021 cache TTL in seconds (1 minute)
+ */
+exports.STATUSLIST_CACHE_SEC = 60;
+/**
+ * DID resolution timeout in milliseconds (500ms)
+ */
+exports.DID_RESOLVE_TIMEOUT_MS = 500;
+/**
+ * Default session TTL in minutes (30 minutes)
+ */
+exports.DEFAULT_SESSION_TTL_MINUTES = 30;
+/**
+ * Maximum timestamp skew in seconds (2 minutes)
+ */
+exports.MAX_TIMESTAMP_SKEW_SEC = 120;
+/**
+ * Maximum delegation chain depth
+ */
+exports.MAX_DELEGATION_CHAIN_DEPTH = 10;
+/**
+ * Maximum status list size (1 million entries)
+ */
+exports.MAX_STATUSLIST_SIZE = 1000000;
+/**
+ * Proof archive TTL in seconds (30 days)
+ */
+exports.PROOF_ARCHIVE_TTL_SEC = 30 * 24 * 60 * 60;
+/**
+ * Key rotation grace period in seconds (24 hours)
+ */
+exports.KEY_ROTATION_GRACE_PERIOD_SEC = 24 * 60 * 60;
+//# sourceMappingURL=constants.js.map

package/dist/env/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Environment Constants Module
+ */
+export * from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/env/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Environment Constants Module
+ */
+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("./constants.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -3,6 +3,14 @@
  *
  * This package provides a single source of truth for all types and contracts
  * used across the XMCP-I ecosystem, including runtime, CLI, verifier, and registry.
+ *
+ * NOTE: Some exports may conflict. Use subpath imports for new modules:
+ * - import { ... } from '@kya-os/contracts/did'
+ * - import { ... } from '@kya-os/contracts/vc'
+ * - import { ... } from '@kya-os/contracts/delegation'
+ * - import { ... } from '@kya-os/contracts/runtime'
+ * - import { ... } from '@kya-os/contracts/tlkrc'
+ * - import { ... } from '@kya-os/contracts/env'
  */
 export * from "./handshake.js";
 export * from "./proof.js";
@@ -11,6 +19,6 @@ export * from "./registry.js";
 export * from "./cli.js";
 export * from "./test.js";
 export * from "./utils/validation.js";
-export declare const CONTRACTS_VERSION = "1.0.0";
+export declare const CONTRACTS_VERSION = "1.2.1";
 export declare const SUPPORTED_XMCP_I_VERSION = "^1.0.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -4,6 +4,14 @@
  *
  * This package provides a single source of truth for all types and contracts
  * used across the XMCP-I ecosystem, including runtime, CLI, verifier, and registry.
+ *
+ * NOTE: Some exports may conflict. Use subpath imports for new modules:
+ * - import { ... } from '@kya-os/contracts/did'
+ * - import { ... } from '@kya-os/contracts/vc'
+ * - import { ... } from '@kya-os/contracts/delegation'
+ * - import { ... } from '@kya-os/contracts/runtime'
+ * - import { ... } from '@kya-os/contracts/tlkrc'
+ * - import { ... } from '@kya-os/contracts/env'
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -21,7 +29,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SUPPORTED_XMCP_I_VERSION = exports.CONTRACTS_VERSION = void 0;
-// Re-export all schemas and types from submodules
+// Legacy exports (maintain backward compatibility)
 __exportStar(require("./handshake.js"), exports);
 __exportStar(require("./proof.js"), exports);
 __exportStar(require("./verifier.js"), exports);
@@ -30,6 +38,13 @@ __exportStar(require("./cli.js"), exports);
 __exportStar(require("./test.js"), exports);
 __exportStar(require("./utils/validation.js"), exports);
 // Version information
-exports.CONTRACTS_VERSION = "1.0.0";
+exports.CONTRACTS_VERSION = "1.2.1";
 exports.SUPPORTED_XMCP_I_VERSION = "^1.0.0";
+// New MCP-I contract types are available via subpath imports:
+// import { ... } from '@kya-os/contracts/did'
+// import { ... } from '@kya-os/contracts/vc'
+// import { ... } from '@kya-os/contracts/delegation'
+// import { ... } from '@kya-os/contracts/runtime'
+// import { ... } from '@kya-os/contracts/tlkrc'
+// import { ... } from '@kya-os/contracts/env'
 //# sourceMappingURL=index.js.map

package/dist/proof/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Proof Module Exports
+ *
+ * Note: This module exports proof record and signing spec types.
+ * The existing proof.ts file with DetachedProofSchema is separate.
+ */
+export * from './signing-spec.js';
+export * from './proof-record.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/proof/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Proof Module Exports
+ *
+ * Note: This module exports proof record and signing spec types.
+ * The existing proof.ts file with DetachedProofSchema is separate.
+ */
+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("./signing-spec.js"), exports);
+__exportStar(require("./proof-record.js"), exports);
+//# sourceMappingURL=index.js.map