@x12i/ai-profiles 1.0.0

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validation/validateModelsProfilesJson.d.ts

@@ -0,0 +1,4 @@
+import type { AIProfileDefinition, ModelsProfilesJson, ProfilesShortcutsJson } from "../types.js";
+export declare function validateModelsProfilesJson(value: unknown): ModelsProfilesJson;
+export declare function validateProfilesShortcutsJson(value: unknown, profiles: Record<string, AIProfileDefinition>): ProfilesShortcutsJson;
+//# sourceMappingURL=validateModelsProfilesJson.d.ts.map

package/dist/validation/validateModelsProfilesJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateModelsProfilesJson.d.ts","sourceRoot":"","sources":["../../src/validation/validateModelsProfilesJson.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAmGrB,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CA8C7E;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAC5C,qBAAqB,CAmEvB"}

package/dist/validation/validateModelsProfilesJson.js

@@ -0,0 +1,93 @@
+import { AIProfilesError } from "../errors.js";
+import { MODELS_PROFILES_SCHEMA, PROFILES_SHORTCUTS_SCHEMA, } from "../constants.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireString(value, field, context) {
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", `Missing or invalid ${field} in ${context}`, { field, context });
+    }
+    return value;
+}
+function validateChoice(choiceKey, choice, profileKey) {
+    if (!isRecord(choice)) {
+        throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", `Invalid choice '${choiceKey}' for profile '${profileKey}'`, { profile: profileKey, choice: choiceKey });
+    }
+    requireString(choice.choice, "choice", `profile '${profileKey}' choice '${choiceKey}'`);
+    requireString(choice.displayName, "displayName", `profile '${profileKey}' choice '${choiceKey}'`);
+    requireString(choice.description, "description", `profile '${profileKey}' choice '${choiceKey}'`);
+    requireString(choice.provider, "provider", `profile '${profileKey}' choice '${choiceKey}'`);
+    requireString(choice.modelId, "modelId", `profile '${profileKey}' choice '${choiceKey}'`);
+}
+function validateProfile(profileKey, profile) {
+    if (!isRecord(profile)) {
+        throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", `Invalid profile '${profileKey}'`, { profile: profileKey });
+    }
+    requireString(profile.profile, "profile", `profile '${profileKey}'`);
+    requireString(profile.displayName, "displayName", `profile '${profileKey}'`);
+    requireString(profile.description, "description", `profile '${profileKey}'`);
+    requireString(profile.category, "category", `profile '${profileKey}'`);
+    requireString(profile.defaultChoice, "defaultChoice", `profile '${profileKey}'`);
+    if (!isRecord(profile.choices)) {
+        throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", `Missing choices for profile '${profileKey}'`, { profile: profileKey });
+    }
+    const defaultChoice = profile.defaultChoice;
+    if (!profile.choices[defaultChoice]) {
+        throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", `Profile '${profileKey}' defaultChoice '${defaultChoice}' does not exist`, { profile: profileKey, defaultChoice });
+    }
+    for (const [choiceKey, choice] of Object.entries(profile.choices)) {
+        validateChoice(choiceKey, choice, profileKey);
+    }
+}
+export function validateModelsProfilesJson(value) {
+    if (!isRecord(value)) {
+        throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", "models-profiles.json must be an object");
+    }
+    if (value.schema !== MODELS_PROFILES_SCHEMA) {
+        throw new AIProfilesError(value.schema ? "REGISTRY_SCHEMA_UNSUPPORTED" : "REGISTRY_VALIDATION_FAILED", `Unsupported or missing models-profiles schema: ${String(value.schema)}`, { schema: value.schema });
+    }
+    requireString(value.version, "version", "models-profiles.json");
+    if (value.currency !== "USD") {
+        throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", "models-profiles.json currency must be USD", { currency: value.currency });
+    }
+    if (value.pricingUnit !== "1M_tokens") {
+        throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", "models-profiles.json pricingUnit must be 1M_tokens", { pricingUnit: value.pricingUnit });
+    }
+    if (!isRecord(value.profiles)) {
+        throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", "models-profiles.json profiles must be an object");
+    }
+    for (const [profileKey, profile] of Object.entries(value.profiles)) {
+        validateProfile(profileKey, profile);
+    }
+    return value;
+}
+export function validateProfilesShortcutsJson(value, profiles) {
+    if (!isRecord(value)) {
+        throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", "profiles-shortcuts.json must be an object");
+    }
+    if (value.schema !== PROFILES_SHORTCUTS_SCHEMA) {
+        throw new AIProfilesError(value.schema ? "REGISTRY_SCHEMA_UNSUPPORTED" : "REGISTRY_VALIDATION_FAILED", `Unsupported or missing profiles-shortcuts schema: ${String(value.schema)}`, { schema: value.schema });
+    }
+    requireString(value.version, "version", "profiles-shortcuts.json");
+    if (!isRecord(value.shortcuts)) {
+        throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", "profiles-shortcuts.json shortcuts must be an object");
+    }
+    for (const [shortcutKey, shortcut] of Object.entries(value.shortcuts)) {
+        if (!isRecord(shortcut)) {
+            throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", `Invalid shortcut '${shortcutKey}'`, { shortcut: shortcutKey });
+        }
+        const profileKey = requireString(shortcut.profile, "profile", `shortcut '${shortcutKey}'`);
+        const profile = profiles[profileKey];
+        if (!profile) {
+            throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", `Shortcut '${shortcutKey}' references unknown profile '${profileKey}'`, { shortcut: shortcutKey, profile: profileKey });
+        }
+        if (shortcut.choice !== undefined) {
+            const choiceKey = requireString(shortcut.choice, "choice", `shortcut '${shortcutKey}'`);
+            if (!profile.choices[choiceKey]) {
+                throw new AIProfilesError("REGISTRY_VALIDATION_FAILED", `Shortcut '${shortcutKey}' references unknown choice '${choiceKey}' for profile '${profileKey}'`, { shortcut: shortcutKey, profile: profileKey, choice: choiceKey });
+            }
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=validateModelsProfilesJson.js.map

package/dist/validation/validateModelsProfilesJson.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@x12i/ai-profiles",
+  "version": "1.0.0",
+  "description": "Resolve AI profile names into concrete model choices with bundled defaults and remote JSON refresh",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc && node scripts/copy-data.mjs",
+    "test": "npm run build && vitest run",
+    "test:unit": "vitest run --exclude 'test/{integration,exports}.test.ts'",
+    "test:integration": "npm run build && vitest run test/integration.test.ts test/exports.test.ts",
+    "test:watch": "vitest",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm test",
+    "pack:check": "npm pack --dry-run",
+    "publish:public": "npm publish --access public"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/x12i/ai-profiles.git"
+  },
+  "bugs": {
+    "url": "https://github.com/x12i/ai-profiles/issues"
+  },
+  "homepage": "https://github.com/x12i/ai-profiles#readme",
+  "keywords": [
+    "ai",
+    "profiles",
+    "models",
+    "llm",
+    "x12i",
+    "model-selection",
+    "gemini",
+    "openai",
+    "anthropic"
+  ],
+  "author": "x12i",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
+  }
+}