@skild/core 0.2.8 → 0.2.9

package/dist/index.d.ts

@@ -140,6 +140,10 @@ declare function initSkill(name: string, options?: InitOptions): string;
 
 declare function fetchWithTimeout(input: RequestInfo | URL, init?: RequestInit, timeoutMs?: number): Promise<Response>;
 
+declare function normalizeAlias(input: unknown): string | null;
+declare function isValidAlias(input: string): boolean;
+declare function assertValidAlias(input: string): void;
+
 declare const DEFAULT_REGISTRY_URL = "https://registry.skild.sh";
 interface RegistrySpecifier {
     canonicalName: string;
@@ -211,4 +215,4 @@ declare function uninstallSkill(name: string, options?: InstallOptions & {
 }): void;
 declare function updateSkill(name?: string, options?: UpdateOptions): Promise<InstallRecord[]>;
 
-export { DEFAULT_REGISTRY_URL, type DependencySourceType, type GlobalConfig, type InstallOptions, type InstallRecord, type InstallScope, type InstalledDependency, type ListOptions, type Lockfile, PLATFORMS, type Platform, type RegistryAuth, SkildError, type SkillFrontmatter, type SkillValidationIssue, type SkillValidationResult, type UpdateOptions, canonicalNameToInstallDirName, clearRegistryAuth, downloadAndExtractTarball, fetchWithTimeout, getSkillInfo, getSkillInstallDir, getSkillsDir, initSkill, installRegistrySkill, installSkill, listAllSkills, listSkills, loadOrCreateGlobalConfig, loadRegistryAuth, parseRegistrySpecifier, resolveRegistryAlias, resolveRegistryUrl, resolveRegistryVersion, saveRegistryAuth, searchRegistrySkills, splitCanonicalName, uninstallSkill, updateSkill, validateSkill, validateSkillDir };
+export { DEFAULT_REGISTRY_URL, type DependencySourceType, type GlobalConfig, type InstallOptions, type InstallRecord, type InstallScope, type InstalledDependency, type ListOptions, type Lockfile, PLATFORMS, type Platform, type RegistryAuth, SkildError, type SkillFrontmatter, type SkillValidationIssue, type SkillValidationResult, type UpdateOptions, assertValidAlias, canonicalNameToInstallDirName, clearRegistryAuth, downloadAndExtractTarball, fetchWithTimeout, getSkillInfo, getSkillInstallDir, getSkillsDir, initSkill, installRegistrySkill, installSkill, isValidAlias, listAllSkills, listSkills, loadOrCreateGlobalConfig, loadRegistryAuth, normalizeAlias, parseRegistrySpecifier, resolveRegistryAlias, resolveRegistryUrl, resolveRegistryVersion, saveRegistryAuth, searchRegistrySkills, splitCanonicalName, uninstallSkill, updateSkill, validateSkill, validateSkillDir };

package/dist/index.js

@@ -262,6 +262,33 @@ async function fetchWithTimeout(input, init = {}, timeoutMs = 1e4) {
   }
 }
 
+// src/alias.ts
+function normalizeAlias(input) {
+  if (typeof input !== "string") return null;
+  const v = input.trim();
+  return v ? v : null;
+}
+function isValidAlias(input) {
+  const alias = input.trim();
+  if (!alias) return false;
+  if (alias.length < 3 || alias.length > 64) return false;
+  if (alias.includes("--")) return false;
+  return /^[a-z0-9][a-z0-9-]*[a-z0-9]$/.test(alias);
+}
+function assertValidAlias(input) {
+  const alias = input.trim();
+  if (!alias) throw new SkildError("INVALID_SOURCE", "Missing alias.");
+  if (alias.length < 3 || alias.length > 64) {
+    throw new SkildError("INVALID_SOURCE", "Alias length must be between 3 and 64.");
+  }
+  if (alias.includes("--")) {
+    throw new SkildError("INVALID_SOURCE", "Invalid alias format: consecutive hyphens are not allowed.");
+  }
+  if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$/.test(alias)) {
+    throw new SkildError("INVALID_SOURCE", "Invalid alias format. Use lowercase letters, numbers, and hyphens.");
+  }
+}
+
 // src/registry.ts
 import fs5 from "fs";
 import path5 from "path";
@@ -1084,6 +1111,7 @@ export {
   DEFAULT_REGISTRY_URL,
   PLATFORMS,
   SkildError,
+  assertValidAlias,
   canonicalNameToInstallDirName,
   clearRegistryAuth,
   downloadAndExtractTarball,
@@ -1094,10 +1122,12 @@ export {
   initSkill,
   installRegistrySkill,
   installSkill,
+  isValidAlias,
   listAllSkills,
   listSkills,
   loadOrCreateGlobalConfig,
   loadRegistryAuth,
+  normalizeAlias,
   parseRegistrySpecifier,
   resolveRegistryAlias,
   resolveRegistryUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skild/core",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Skild core library (headless) for installing, validating, and managing Agent Skills locally.",
   "type": "module",
   "main": "./dist/index.js",