@vorionsys/shared-constants 1.0.0

package/dist/chunk-TYCMBQGU.js

@@ -0,0 +1,353 @@
+// src/error-codes.ts
+var ErrorCategory = /* @__PURE__ */ ((ErrorCategory2) => {
+  ErrorCategory2["AUTH"] = "auth";
+  ErrorCategory2["VALIDATION"] = "validation";
+  ErrorCategory2["RATE_LIMIT"] = "rate_limit";
+  ErrorCategory2["NOT_FOUND"] = "not_found";
+  ErrorCategory2["TRUST"] = "trust";
+  ErrorCategory2["SERVER"] = "server";
+  ErrorCategory2["EXTERNAL"] = "external";
+  ErrorCategory2["CONFIG"] = "config";
+  return ErrorCategory2;
+})(ErrorCategory || {});
+var AUTH_ERRORS = {
+  MISSING_API_KEY: {
+    code: "E1001",
+    httpStatus: 401,
+    category: "auth" /* AUTH */,
+    message: "API key is missing. Include it in the Authorization header.",
+    retryable: false,
+    docsUrl: "https://cognigate.dev/docs/authentication"
+  },
+  INVALID_API_KEY: {
+    code: "E1002",
+    httpStatus: 401,
+    category: "auth" /* AUTH */,
+    message: "API key is invalid or has been revoked.",
+    retryable: false,
+    docsUrl: "https://cognigate.dev/docs/authentication"
+  },
+  EXPIRED_API_KEY: {
+    code: "E1003",
+    httpStatus: 401,
+    category: "auth" /* AUTH */,
+    message: "API key has expired. Generate a new key.",
+    retryable: false,
+    docsUrl: "https://cognigate.dev/docs/authentication"
+  },
+  INSUFFICIENT_PERMISSIONS: {
+    code: "E1004",
+    httpStatus: 403,
+    category: "auth" /* AUTH */,
+    message: "Insufficient permissions for this operation.",
+    retryable: false
+  },
+  AGENT_NOT_AUTHORIZED: {
+    code: "E1005",
+    httpStatus: 403,
+    category: "auth" /* AUTH */,
+    message: "Agent is not authorized for this action.",
+    retryable: false
+  },
+  TOKEN_EXPIRED: {
+    code: "E1006",
+    httpStatus: 401,
+    category: "auth" /* AUTH */,
+    message: "Authentication token has expired.",
+    retryable: false
+  },
+  MFA_REQUIRED: {
+    code: "E1007",
+    httpStatus: 403,
+    category: "auth" /* AUTH */,
+    message: "Multi-factor authentication is required for this operation.",
+    retryable: false
+  }
+};
+var VALIDATION_ERRORS = {
+  INVALID_REQUEST: {
+    code: "E2001",
+    httpStatus: 400,
+    category: "validation" /* VALIDATION */,
+    message: "Request body is invalid or malformed.",
+    retryable: false
+  },
+  MISSING_REQUIRED_FIELD: {
+    code: "E2002",
+    httpStatus: 400,
+    category: "validation" /* VALIDATION */,
+    message: "Required field is missing: {field}",
+    retryable: false
+  },
+  INVALID_FIELD_TYPE: {
+    code: "E2003",
+    httpStatus: 400,
+    category: "validation" /* VALIDATION */,
+    message: "Field {field} has invalid type. Expected {expected}.",
+    retryable: false
+  },
+  INVALID_FIELD_VALUE: {
+    code: "E2004",
+    httpStatus: 400,
+    category: "validation" /* VALIDATION */,
+    message: "Field {field} has invalid value.",
+    retryable: false
+  },
+  PAYLOAD_TOO_LARGE: {
+    code: "E2005",
+    httpStatus: 413,
+    category: "validation" /* VALIDATION */,
+    message: "Request payload exceeds maximum size of {maxSize}.",
+    retryable: false
+  },
+  INVALID_JSON: {
+    code: "E2006",
+    httpStatus: 400,
+    category: "validation" /* VALIDATION */,
+    message: "Request body is not valid JSON.",
+    retryable: false
+  },
+  INVALID_CAR_ID: {
+    code: "E2007",
+    httpStatus: 400,
+    category: "validation" /* VALIDATION */,
+    message: "Invalid CAR ID format. Expected: car:domain/category/name:version",
+    retryable: false,
+    docsUrl: "https://carid.vorion.org/format"
+  },
+  INVALID_TRUST_SCORE: {
+    code: "E2008",
+    httpStatus: 400,
+    category: "validation" /* VALIDATION */,
+    message: "Trust score must be between 0 and 1000.",
+    retryable: false
+  }
+};
+var RATE_LIMIT_ERRORS = {
+  RATE_LIMIT_EXCEEDED: {
+    code: "E3001",
+    httpStatus: 429,
+    category: "rate_limit" /* RATE_LIMIT */,
+    message: "Rate limit exceeded. Retry after {retryAfter} seconds.",
+    retryable: true
+  },
+  QUOTA_EXCEEDED: {
+    code: "E3002",
+    httpStatus: 429,
+    category: "rate_limit" /* RATE_LIMIT */,
+    message: "Monthly quota exceeded. Upgrade your tier or wait for reset.",
+    retryable: false
+  },
+  CONCURRENT_LIMIT: {
+    code: "E3003",
+    httpStatus: 429,
+    category: "rate_limit" /* RATE_LIMIT */,
+    message: "Too many concurrent requests. Max burst: {burstLimit}.",
+    retryable: true
+  },
+  DAILY_LIMIT_EXCEEDED: {
+    code: "E3004",
+    httpStatus: 429,
+    category: "rate_limit" /* RATE_LIMIT */,
+    message: "Daily request limit exceeded. Resets at midnight UTC.",
+    retryable: true
+  }
+};
+var NOT_FOUND_ERRORS = {
+  RESOURCE_NOT_FOUND: {
+    code: "E4001",
+    httpStatus: 404,
+    category: "not_found" /* NOT_FOUND */,
+    message: "Resource not found: {resourceType}/{resourceId}",
+    retryable: false
+  },
+  AGENT_NOT_FOUND: {
+    code: "E4002",
+    httpStatus: 404,
+    category: "not_found" /* NOT_FOUND */,
+    message: "Agent not found: {agentId}",
+    retryable: false
+  },
+  PROOF_NOT_FOUND: {
+    code: "E4003",
+    httpStatus: 404,
+    category: "not_found" /* NOT_FOUND */,
+    message: "Proof not found: {proofId}",
+    retryable: false
+  },
+  ENDPOINT_NOT_FOUND: {
+    code: "E4004",
+    httpStatus: 404,
+    category: "not_found" /* NOT_FOUND */,
+    message: "API endpoint not found.",
+    retryable: false
+  },
+  ATTESTATION_NOT_FOUND: {
+    code: "E4005",
+    httpStatus: 404,
+    category: "not_found" /* NOT_FOUND */,
+    message: "Attestation not found: {attestationId}",
+    retryable: false
+  }
+};
+var TRUST_ERRORS = {
+  TRUST_TIER_INSUFFICIENT: {
+    code: "E5001",
+    httpStatus: 403,
+    category: "trust" /* TRUST */,
+    message: "Trust tier {currentTier} insufficient. Required: {requiredTier}.",
+    retryable: false,
+    docsUrl: "https://basis.vorion.org/tiers"
+  },
+  CAPABILITY_NOT_AVAILABLE: {
+    code: "E5002",
+    httpStatus: 403,
+    category: "trust" /* TRUST */,
+    message: "Capability {capability} not available at tier {tier}.",
+    retryable: false,
+    docsUrl: "https://cognigate.dev/docs/capabilities"
+  },
+  GOVERNANCE_DENIED: {
+    code: "E5003",
+    httpStatus: 403,
+    category: "trust" /* TRUST */,
+    message: "Action denied by governance policy: {reason}.",
+    retryable: false
+  },
+  AGENT_SUSPENDED: {
+    code: "E5004",
+    httpStatus: 403,
+    category: "trust" /* TRUST */,
+    message: "Agent is suspended. Contact support for reinstatement.",
+    retryable: false
+  },
+  PROOF_VERIFICATION_FAILED: {
+    code: "E5005",
+    httpStatus: 400,
+    category: "trust" /* TRUST */,
+    message: "Proof verification failed: {reason}.",
+    retryable: false
+  },
+  ATTESTATION_INVALID: {
+    code: "E5006",
+    httpStatus: 400,
+    category: "trust" /* TRUST */,
+    message: "Attestation is invalid or has expired.",
+    retryable: false
+  },
+  ESCALATION_REQUIRED: {
+    code: "E5007",
+    httpStatus: 403,
+    category: "trust" /* TRUST */,
+    message: "Action requires human approval. Escalation ID: {escalationId}.",
+    retryable: false
+  }
+};
+var SERVER_ERRORS = {
+  INTERNAL_ERROR: {
+    code: "E6001",
+    httpStatus: 500,
+    category: "server" /* SERVER */,
+    message: "An internal error occurred. Please try again later.",
+    retryable: true
+  },
+  SERVICE_UNAVAILABLE: {
+    code: "E6002",
+    httpStatus: 503,
+    category: "server" /* SERVER */,
+    message: "Service is temporarily unavailable. Please try again later.",
+    retryable: true
+  },
+  DATABASE_ERROR: {
+    code: "E6003",
+    httpStatus: 500,
+    category: "server" /* SERVER */,
+    message: "Database operation failed. Please try again later.",
+    retryable: true
+  },
+  MAINTENANCE_MODE: {
+    code: "E6004",
+    httpStatus: 503,
+    category: "server" /* SERVER */,
+    message: "Service is under maintenance. Expected completion: {eta}.",
+    retryable: true
+  }
+};
+var EXTERNAL_ERRORS = {
+  BLOCKCHAIN_ERROR: {
+    code: "E7001",
+    httpStatus: 502,
+    category: "external" /* EXTERNAL */,
+    message: "Blockchain network error. Please try again later.",
+    retryable: true
+  },
+  UPSTREAM_TIMEOUT: {
+    code: "E7002",
+    httpStatus: 504,
+    category: "external" /* EXTERNAL */,
+    message: "Upstream service timed out.",
+    retryable: true
+  },
+  EXTERNAL_SERVICE_ERROR: {
+    code: "E7003",
+    httpStatus: 502,
+    category: "external" /* EXTERNAL */,
+    message: "External service error: {service}.",
+    retryable: true
+  }
+};
+var ERROR_CODES = {
+  ...AUTH_ERRORS,
+  ...VALIDATION_ERRORS,
+  ...RATE_LIMIT_ERRORS,
+  ...NOT_FOUND_ERRORS,
+  ...TRUST_ERRORS,
+  ...SERVER_ERRORS,
+  ...EXTERNAL_ERRORS
+};
+function getErrorByCode(code) {
+  return Object.values(ERROR_CODES).find((e) => e.code === code);
+}
+function getErrorsByCategory(category) {
+  return Object.values(ERROR_CODES).filter((e) => e.category === category);
+}
+function getRetryableErrors() {
+  return Object.values(ERROR_CODES).filter((e) => e.retryable);
+}
+function formatErrorMessage(error, params) {
+  let message = error.message;
+  for (const [key, value] of Object.entries(params)) {
+    message = message.replace(`{${key}}`, String(value));
+  }
+  return message;
+}
+function createErrorResponse(error, params, requestId) {
+  return {
+    error: {
+      code: error.code,
+      message: params ? formatErrorMessage(error, params) : error.message,
+      category: error.category,
+      retryable: error.retryable,
+      ...error.docsUrl && { docsUrl: error.docsUrl },
+      ...requestId && { requestId }
+    },
+    status: error.httpStatus
+  };
+}
+
+export {
+  ErrorCategory,
+  AUTH_ERRORS,
+  VALIDATION_ERRORS,
+  RATE_LIMIT_ERRORS,
+  NOT_FOUND_ERRORS,
+  TRUST_ERRORS,
+  SERVER_ERRORS,
+  EXTERNAL_ERRORS,
+  ERROR_CODES,
+  getErrorByCode,
+  getErrorsByCategory,
+  getRetryableErrors,
+  formatErrorMessage,
+  createErrorResponse
+};

package/dist/chunk-UDCZKJSQ.js

@@ -0,0 +1,139 @@
+// src/api-versions.ts
+var VersionStatus = /* @__PURE__ */ ((VersionStatus2) => {
+  VersionStatus2["DEVELOPMENT"] = "development";
+  VersionStatus2["PREVIEW"] = "preview";
+  VersionStatus2["STABLE"] = "stable";
+  VersionStatus2["DEPRECATED"] = "deprecated";
+  VersionStatus2["RETIRED"] = "retired";
+  return VersionStatus2;
+})(VersionStatus || {});
+var COGNIGATE_VERSIONS = {
+  v1: {
+    version: "v1",
+    fullVersion: "1.0.0",
+    releaseDate: "2026-02-01",
+    status: "stable" /* STABLE */,
+    changelogUrl: "https://cognigate.dev/changelog/v1"
+  }
+};
+var COGNIGATE_CURRENT_VERSION = "v1";
+var COGNIGATE_DEFAULT_VERSION = "v1";
+var TRUST_API_VERSIONS = {
+  v1: {
+    version: "v1",
+    fullVersion: "1.0.0",
+    releaseDate: "2026-02-01",
+    status: "stable" /* STABLE */,
+    changelogUrl: "https://trust.agentanchorai.com/changelog/v1"
+  }
+};
+var TRUST_CURRENT_VERSION = "v1";
+var LOGIC_API_VERSIONS = {
+  v1: {
+    version: "v1",
+    fullVersion: "1.0.0",
+    releaseDate: "2026-02-01",
+    status: "preview" /* PREVIEW */,
+    changelogUrl: "https://logic.agentanchorai.com/changelog/v1"
+  }
+};
+var LOGIC_CURRENT_VERSION = "v1";
+var BASIS_VERSIONS = {
+  v1: {
+    version: "v1",
+    fullVersion: "1.0.0",
+    releaseDate: "2026-02-01",
+    status: "stable" /* STABLE */,
+    changelogUrl: "https://basis.vorion.org/changelog"
+  }
+};
+var BASIS_CURRENT_VERSION = "v1";
+var BASIS_SPEC_VERSION = "1.0.0";
+var CAR_SPEC_VERSIONS = {
+  v1: {
+    version: "v1",
+    fullVersion: "1.0.0",
+    releaseDate: "2026-02-01",
+    status: "stable" /* STABLE */,
+    changelogUrl: "https://carid.vorion.org/changelog"
+  }
+};
+var CAR_SPEC_CURRENT_VERSION = "v1";
+var API_VERSIONS = {
+  cognigate: COGNIGATE_VERSIONS,
+  trust: TRUST_API_VERSIONS,
+  logic: LOGIC_API_VERSIONS,
+  basis: BASIS_VERSIONS,
+  carSpec: CAR_SPEC_VERSIONS
+};
+function getCurrentVersion(service) {
+  switch (service) {
+    case "cognigate":
+      return COGNIGATE_CURRENT_VERSION;
+    case "trust":
+      return TRUST_CURRENT_VERSION;
+    case "logic":
+      return LOGIC_CURRENT_VERSION;
+    case "basis":
+      return BASIS_CURRENT_VERSION;
+    case "carSpec":
+      return CAR_SPEC_CURRENT_VERSION;
+  }
+}
+function getVersionDefinition(service, version) {
+  return API_VERSIONS[service][version];
+}
+function isVersionSupported(service, version) {
+  const def = getVersionDefinition(service, version);
+  if (!def) return false;
+  return def.status !== "retired" /* RETIRED */;
+}
+function isVersionDeprecated(service, version) {
+  const def = getVersionDefinition(service, version);
+  if (!def) return false;
+  return def.status === "deprecated" /* DEPRECATED */;
+}
+function getStableVersions(service) {
+  return Object.values(API_VERSIONS[service]).filter(
+    (v) => v.status === "stable" /* STABLE */
+  );
+}
+function buildApiUrl(baseUrl, version, path) {
+  const cleanBase = baseUrl.replace(/\/$/, "");
+  const cleanPath = path.replace(/^\//, "");
+  return `${cleanBase}/${version}/${cleanPath}`;
+}
+var VERSION_HEADERS = {
+  /** Header to request specific API version */
+  REQUEST_VERSION: "X-API-Version",
+  /** Header indicating actual API version used */
+  RESPONSE_VERSION: "X-API-Version",
+  /** Header warning about deprecation */
+  DEPRECATION_WARNING: "X-Deprecation-Warning",
+  /** Header with sunset date */
+  SUNSET: "Sunset"
+};
+
+export {
+  VersionStatus,
+  COGNIGATE_VERSIONS,
+  COGNIGATE_CURRENT_VERSION,
+  COGNIGATE_DEFAULT_VERSION,
+  TRUST_API_VERSIONS,
+  TRUST_CURRENT_VERSION,
+  LOGIC_API_VERSIONS,
+  LOGIC_CURRENT_VERSION,
+  BASIS_VERSIONS,
+  BASIS_CURRENT_VERSION,
+  BASIS_SPEC_VERSION,
+  CAR_SPEC_VERSIONS,
+  CAR_SPEC_CURRENT_VERSION,
+  API_VERSIONS,
+  getCurrentVersion,
+  getVersionDefinition,
+  isVersionSupported,
+  isVersionDeprecated,
+  getStableVersions,
+  buildApiUrl,
+  VERSION_HEADERS
+};

package/dist/domains.cjs

@@ -0,0 +1,175 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/domains.ts
+var domains_exports = {};
+__export(domains_exports, {
+  AGENTANCHOR_DOMAINS: () => AGENTANCHOR_DOMAINS,
+  AGENTANCHOR_EMAILS: () => AGENTANCHOR_EMAILS,
+  ALL_DOMAINS: () => ALL_DOMAINS,
+  API_ENDPOINTS: () => API_ENDPOINTS,
+  COGNIGATE_DOMAINS: () => COGNIGATE_DOMAINS,
+  DOMAIN_ALIASES: () => DOMAIN_ALIASES,
+  GITHUB: () => GITHUB,
+  NPM_PACKAGES: () => NPM_PACKAGES,
+  VORION_DOMAINS: () => VORION_DOMAINS,
+  VORION_EMAILS: () => VORION_EMAILS
+});
+module.exports = __toCommonJS(domains_exports);
+var VORION_DOMAINS = {
+  /** Main Vorion organization site */
+  main: "https://vorion.org",
+  /** BASIS specification and documentation */
+  basis: "https://basis.vorion.org",
+  /** CAR ID specification */
+  carId: "https://carid.vorion.org",
+  /** ATSF (Agent Trust & Safety Framework) */
+  atsf: "https://atsf.vorion.org",
+  /** Learning and educational resources (primary) */
+  learn: "https://learn.vorion.org",
+  /** Kaizen - Interactive AI Learning Experience (mirrors learn) */
+  kaizen: "https://kaizen.vorion.org",
+  /** Technical documentation */
+  docs: "https://docs.vorion.org",
+  /** Community forum */
+  community: "https://community.vorion.org"
+};
+var DOMAIN_ALIASES = {
+  "kaizen.vorion.org": "learn.vorion.org"
+};
+var AGENTANCHOR_DOMAINS = {
+  /** Main Agent Anchor AI site */
+  main: "https://agentanchorai.com",
+  /** Agent Anchor Trust - Trust verification and certification */
+  trust: "https://trust.agentanchorai.com",
+  /** Agent Anchor Logic - Policy engine and governance logic */
+  logic: "https://logic.agentanchorai.com",
+  /** Status page */
+  status: "https://status.agentanchorai.com"
+};
+var COGNIGATE_DOMAINS = {
+  /** Cognigate main site and documentation */
+  main: "https://cognigate.dev",
+  /** Cognigate API documentation */
+  docs: "https://cognigate.dev/docs"
+};
+var API_ENDPOINTS = {
+  /** Cognigate Production API */
+  cognigate: {
+    production: "https://cognigate.dev/v1",
+    staging: "https://staging.cognigate.dev/v1"
+  },
+  /** Agent Anchor AI Production API */
+  agentAnchor: {
+    production: "https://api.agentanchorai.com/v1",
+    staging: "https://staging-api.agentanchorai.com/v1",
+    sandbox: "https://sandbox.agentanchorai.com/v1"
+  },
+  /** Trust API */
+  trust: {
+    production: "https://trust.agentanchorai.com/v1",
+    staging: "https://staging.trust.agentanchorai.com/v1"
+  },
+  /** Logic/Policy API */
+  logic: {
+    production: "https://logic.agentanchorai.com/v1",
+    staging: "https://staging.logic.agentanchorai.com/v1"
+  }
+};
+var VORION_EMAILS = {
+  /** General inquiries */
+  info: "info@vorion.org",
+  /** Security reports */
+  security: "security@vorion.org",
+  /** Legal inquiries */
+  legal: "legal@vorion.org",
+  /** Community and contributions */
+  community: "community@vorion.org",
+  /** Contributing */
+  contribute: "contribute@vorion.org"
+};
+var AGENTANCHOR_EMAILS = {
+  /** General support */
+  support: "support@agentanchorai.com",
+  /** Sales inquiries */
+  sales: "sales@agentanchorai.com",
+  /** Partner program */
+  partners: "partners@agentanchorai.com",
+  /** API support */
+  apiSupport: "api-support@agentanchorai.com",
+  /** Enterprise inquiries */
+  enterprise: "enterprise@agentanchorai.com",
+  /** Compliance */
+  compliance: "compliance@agentanchorai.com",
+  /** Team */
+  team: "team@agentanchorai.com"
+};
+var GITHUB = {
+  /** Vorion organization */
+  vorion: {
+    org: "https://github.com/voriongit",
+    mainRepo: "https://github.com/voriongit/vorion"
+  },
+  /** Agent Anchor AI (if separate) */
+  agentAnchor: {
+    org: "https://github.com/agentanchorai"
+  }
+};
+var NPM_PACKAGES = {
+  /** Open source packages (@vorionsys) */
+  vorion: {
+    basis: "@vorionsys/basis",
+    contracts: "@vorionsys/contracts",
+    carSpec: "@vorionsys/car-spec",
+    atsfCore: "@vorionsys/atsf-core",
+    cognigate: "@vorionsys/cognigate",
+    sharedConstants: "@vorionsys/shared-constants"
+  },
+  /** Commercial packages (@agentanchor) */
+  agentAnchor: {
+    sdk: "@agentanchor/sdk",
+    trust: "@agentanchor/trust",
+    logic: "@agentanchor/logic"
+  }
+};
+var ALL_DOMAINS = {
+  vorion: VORION_DOMAINS,
+  agentAnchor: AGENTANCHOR_DOMAINS,
+  cognigate: COGNIGATE_DOMAINS,
+  api: API_ENDPOINTS,
+  emails: {
+    vorion: VORION_EMAILS,
+    agentAnchor: AGENTANCHOR_EMAILS
+  },
+  github: GITHUB,
+  npm: NPM_PACKAGES
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AGENTANCHOR_DOMAINS,
+  AGENTANCHOR_EMAILS,
+  ALL_DOMAINS,
+  API_ENDPOINTS,
+  COGNIGATE_DOMAINS,
+  DOMAIN_ALIASES,
+  GITHUB,
+  NPM_PACKAGES,
+  VORION_DOMAINS,
+  VORION_EMAILS
+});