capns 0.41.10876 → 0.43.10973

package/capns.js

@@ -785,9 +785,54 @@ const MEDIA_XML = 'media:xml;textable';
 const MEDIA_JSON = 'media:json;textable;keyed';
 const MEDIA_YAML = 'media:yaml;textable;keyed';
 
+// =============================================================================
+// SCHEMA URL CONFIGURATION
+// =============================================================================
+
+const DEFAULT_SCHEMA_BASE = 'https://capns.org/schema';
+
+/**
+ * Get the schema base URL from environment variables or default
+ *
+ * Checks in order:
+ * 1. CAPNS_SCHEMA_BASE_URL environment variable
+ * 2. CAPNS_REGISTRY_URL environment variable + "/schema"
+ * 3. Default: "https://capns.org/schema"
+ *
+ * @returns {string} The schema base URL
+ */
+function getSchemaBaseURL() {
+  if (typeof process !== 'undefined' && process.env) {
+    if (process.env.CAPNS_SCHEMA_BASE_URL) {
+      return process.env.CAPNS_SCHEMA_BASE_URL;
+    }
+    if (process.env.CAPNS_REGISTRY_URL) {
+      return process.env.CAPNS_REGISTRY_URL + '/schema';
+    }
+  }
+  return DEFAULT_SCHEMA_BASE;
+}
+
+/**
+ * Get a profile URL for the given profile name
+ *
+ * @param {string} profileName - The profile name (e.g., 'str', 'int')
+ * @returns {string} The full profile URL
+ */
+function getProfileURL(profileName) {
+  return `${getSchemaBaseURL()}/${profileName}`;
+}
+
+// =============================================================================
+// BUILTIN MEDIA SPECS
+// =============================================================================
+
 /**
  * Built-in media URN definitions - canonical media spec strings
  * Maps media URN to canonical format: <media-type>; profile=<url>
+ *
+ * NOTE: These use hardcoded URLs for static initialization.
+ * Use getSchemaBaseURL() and getProfileURL() for dynamic resolution.
  */
 const BUILTIN_SPECS = {
   [MEDIA_STRING]: 'text/plain; profile=https://capns.org/schema/str',
@@ -923,8 +968,9 @@ class MediaSpec {
    * @param {string|null} description - Optional description
    * @param {string|null} mediaUrn - Source media URN for tag-based checks
    * @param {Object|null} validation - Optional validation rules (min, max, min_length, max_length, pattern, allowed_values)
+   * @param {Object|null} metadata - Optional metadata (arbitrary key-value pairs for display/categorization)
    */
-  constructor(contentType, profile = null, schema = null, title = null, description = null, mediaUrn = null, validation = null) {
+  constructor(contentType, profile = null, schema = null, title = null, description = null, mediaUrn = null, validation = null, metadata = null) {
     this.contentType = contentType;
     this.profile = profile;
     this.schema = schema;
@@ -932,6 +978,7 @@ class MediaSpec {
     this.description = description;
     this.mediaUrn = mediaUrn;
     this.validation = validation;
+    this.metadata = metadata;
   }
 
   /**
@@ -1114,13 +1161,14 @@ function resolveMediaUrn(mediaUrn, mediaSpecs = {}) {
       spec.mediaUrn = mediaUrn; // Attach source URN for tag-based checks
       return spec;
     } else if (typeof def === 'object') {
-      // Object form: { media_type, profile_uri, schema?, title?, description?, validation? }
+      // Object form: { media_type, profile_uri, schema?, title?, description?, validation?, metadata? }
       const mediaType = def.media_type || def.mediaType;
       const profileUri = def.profile_uri || def.profileUri;
       const schema = def.schema || null;
       const title = def.title || null;
       const description = def.description || null;
       const validation = def.validation || null;
+      const metadata = def.metadata || null;
 
       if (!mediaType) {
         throw new MediaSpecError(
@@ -1129,7 +1177,7 @@ function resolveMediaUrn(mediaUrn, mediaSpecs = {}) {
         );
       }
 
-      return new MediaSpec(mediaType, profileUri, schema, title, description, mediaUrn, validation);
+      return new MediaSpec(mediaType, profileUri, schema, title, description, mediaUrn, validation, metadata);
     }
   }
 
@@ -3499,6 +3547,8 @@ module.exports = {
   resolveMediaUrn,
   isBuiltinMediaUrn,
   BUILTIN_SPECS,
+  getSchemaBaseURL,
+  getProfileURL,
   MEDIA_STRING,
   MEDIA_INTEGER,
   MEDIA_NUMBER,

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "Bahram Joharshamshiri",
   "dependencies": {
-    "tagged-urn": "^0.10.2767"
+    "tagged-urn": "^0.11.2835"
   },
   "description": "JavaScript implementation of Cap URN (Capability Uniform Resource Names) with strict validation and matching",
   "engines": {
@@ -32,5 +32,5 @@
   "scripts": {
     "test": "node capns.test.js"
   },
-  "version": "0.41.10876"
+  "version": "0.43.10973"
 }