@fractary/codex 0.12.0 → 0.12.4

package/dist/index.cjs

@@ -4,7 +4,7 @@ var micromatch3 = require('micromatch');
 var path3 = require('path');
 var child_process = require('child_process');
 var zod = require('zod');
-var yaml = require('js-yaml');
+var yaml2 = require('js-yaml');
 var fs3 = require('fs/promises');
 var util = require('util');
 
@@ -30,7 +30,7 @@ function _interopNamespace(e) {
 
 var micromatch3__default = /*#__PURE__*/_interopDefault(micromatch3);
 var path3__namespace = /*#__PURE__*/_interopNamespace(path3);
-var yaml__default = /*#__PURE__*/_interopDefault(yaml);
+var yaml2__namespace = /*#__PURE__*/_interopNamespace(yaml2);
 var fs3__namespace = /*#__PURE__*/_interopNamespace(fs3);
 
 var __defProp = Object.defineProperty;
@@ -923,12 +923,24 @@ var DirectionalSyncConfigSchema = zod.z.object({
   /** Patterns to exclude (optional) */
   exclude: zod.z.array(zod.z.string()).optional()
 });
+var FromCodexSyncConfigSchema = DirectionalSyncConfigSchema.refine(
+  (config) => {
+    const includeValid = config.include.every(
+      (pattern) => pattern.startsWith("codex://")
+    );
+    const excludeValid = !config.exclude || config.exclude.every((pattern) => pattern.startsWith("codex://"));
+    return includeValid && excludeValid;
+  },
+  {
+    message: 'from_codex patterns must use codex:// URI format (e.g., "codex://{org}/{codex_repo}/docs/**"). Plain paths like "docs/**" are not valid for from_codex.'
+  }
+);
 var DirectionalSyncSchema = zod.z.object({
   // New format (v0.7.0+) - Recommended
-  // Patterns for files to push from this project to codex
+  // Patterns for files to push from this project to codex (plain paths)
   to_codex: DirectionalSyncConfigSchema.optional(),
-  // Patterns for files to pull from codex to this project
-  from_codex: DirectionalSyncConfigSchema.optional(),
+  // Patterns for files to pull from codex to this project (codex:// URIs required)
+  from_codex: FromCodexSyncConfigSchema.optional(),
   // Global exclude patterns (applied to both directions)
   exclude: zod.z.array(zod.z.string()).optional(),
   // Legacy format (deprecated, backward compatible)
@@ -1046,7 +1058,7 @@ function parseMetadata(content, options = {}) {
   const rawFrontmatter = frontmatterMatch[1];
   const documentContent = frontmatterMatch[2];
   try {
-    const parsed = yaml__default.default.load(rawFrontmatter);
+    const parsed = yaml2__namespace.default.load(rawFrontmatter);
     const normalized = normalizeLegacyMetadata(parsed);
     const metadata = strict ? MetadataSchema.parse(normalized) : MetadataSchema.safeParse(normalized).data || {};
     return {
@@ -3954,17 +3966,17 @@ var SyncManager = class {
         if (file.operation === "create" || file.operation === "update") {
           const sourcePath = `${plan.source}/${file.path}`;
           const targetPath = `${plan.target}/${file.path}`;
-          const fs5 = await import('fs/promises');
+          const fs6 = await import('fs/promises');
           const path7 = await import('path');
           const targetDir = path7.dirname(targetPath);
-          await fs5.mkdir(targetDir, { recursive: true });
-          await fs5.copyFile(sourcePath, targetPath);
+          await fs6.mkdir(targetDir, { recursive: true });
+          await fs6.copyFile(sourcePath, targetPath);
           synced++;
         } else if (file.operation === "delete") {
           const targetPath = `${plan.target}/${file.path}`;
-          const fs5 = await import('fs/promises');
+          const fs6 = await import('fs/promises');
           try {
-            await fs5.unlink(targetPath);
+            await fs6.unlink(targetPath);
             synced++;
           } catch (error) {
             if (error.code !== "ENOENT") {
@@ -4969,6 +4981,176 @@ function generateReferenceMigrationSummary(results) {
   return lines.join("\n");
 }
 
+// src/core/env/index.ts
+function expandEnvVars(value, options = {}) {
+  const env = options.env ?? process.env;
+  return value.replace(/\$\{([^}]+)\}/g, (match, varName) => {
+    const envValue = env[varName];
+    if (envValue === void 0) {
+      if (options.warnOnMissing) {
+        console.warn(`Warning: Environment variable ${varName} is not set`);
+      }
+      if (options.onMissing) {
+        options.onMissing(varName);
+      }
+      return match;
+    }
+    return envValue;
+  });
+}
+function expandEnvVarsInConfig(config, options = {}) {
+  if (typeof config === "string") {
+    return expandEnvVars(config, options);
+  }
+  if (Array.isArray(config)) {
+    return config.map((item) => expandEnvVarsInConfig(item, options));
+  }
+  if (config !== null && typeof config === "object") {
+    const result = {};
+    for (const [key, value] of Object.entries(config)) {
+      result[key] = expandEnvVarsInConfig(value, options);
+    }
+    return result;
+  }
+  return config;
+}
+function hasEnvVars(value) {
+  return /\$\{[^}]+\}/.test(value);
+}
+function extractEnvVarNames(value) {
+  const matches = value.matchAll(/\$\{([^}]+)\}/g);
+  const names = [];
+  for (const match of matches) {
+    if (match[1]) {
+      names.push(match[1]);
+    }
+  }
+  return names;
+}
+async function readCodexConfig(configPath, options = {}) {
+  const content = await fs3__namespace.readFile(configPath, "utf-8");
+  const rawConfig = yaml2__namespace.load(content);
+  let config;
+  if (rawConfig?.codex && typeof rawConfig.codex === "object") {
+    config = rawConfig.codex;
+  } else {
+    config = rawConfig;
+  }
+  if (!config.organization) {
+    throw new Error("Invalid config: organization is required");
+  }
+  if (options.expandEnv !== false) {
+    const envOptions = {
+      env: options.env,
+      warnOnMissing: options.warnOnMissingEnv
+    };
+    config = expandEnvVarsInConfig(config, envOptions);
+  }
+  return config;
+}
+async function readUnifiedConfig(configPath, options = {}) {
+  const content = await fs3__namespace.readFile(configPath, "utf-8");
+  let config = yaml2__namespace.load(content);
+  if (options.expandEnv !== false) {
+    const envOptions = {
+      env: options.env,
+      warnOnMissing: options.warnOnMissingEnv
+    };
+    config = expandEnvVarsInConfig(config, envOptions);
+  }
+  return config;
+}
+function isUnifiedConfig(config) {
+  if (config === null || typeof config !== "object") {
+    return false;
+  }
+  const maybeUnified = config;
+  return "codex" in maybeUnified && maybeUnified.codex !== null && typeof maybeUnified.codex === "object";
+}
+
+// src/core/utils/index.ts
+var DURATION_MULTIPLIERS = {
+  s: 1,
+  // seconds
+  m: 60,
+  // minutes
+  h: 3600,
+  // hours
+  d: 86400,
+  // days
+  w: 604800,
+  // weeks (7 days)
+  M: 2592e3,
+  // months (30 days)
+  y: 31536e3
+  // years (365 days)
+};
+var SIZE_MULTIPLIERS = {
+  B: 1,
+  KB: 1024,
+  MB: 1024 * 1024,
+  GB: 1024 * 1024 * 1024,
+  TB: 1024 * 1024 * 1024 * 1024
+};
+function parseDuration(duration) {
+  if (typeof duration === "number") {
+    return duration;
+  }
+  const match = duration.match(/^(\d+(?:\.\d+)?)\s*([smhdwMy])$/);
+  if (!match || !match[1] || !match[2]) {
+    throw new Error(`Invalid duration format: ${duration}. Use format like "1h", "7d", "1M"`);
+  }
+  const valueStr = match[1];
+  const unit = match[2];
+  const value = parseFloat(valueStr);
+  const multiplier = DURATION_MULTIPLIERS[unit];
+  if (multiplier === void 0) {
+    throw new Error(`Unknown duration unit: ${unit}`);
+  }
+  return Math.round(value * multiplier);
+}
+function parseSize(size) {
+  if (typeof size === "number") {
+    return size;
+  }
+  const match = size.match(/^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB|TB)$/i);
+  if (!match || !match[1] || !match[2]) {
+    throw new Error(`Invalid size format: ${size}. Use format like "100MB", "1GB"`);
+  }
+  const valueStr = match[1];
+  const unit = match[2];
+  const value = parseFloat(valueStr);
+  const multiplier = SIZE_MULTIPLIERS[unit.toUpperCase()];
+  if (multiplier === void 0) {
+    throw new Error(`Unknown size unit: ${unit}`);
+  }
+  return Math.round(value * multiplier);
+}
+function formatBytes2(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+function formatDuration(ms) {
+  if (ms < 1e3) return `${ms}ms`;
+  if (ms < 6e4) return `${(ms / 1e3).toFixed(1)}s`;
+  if (ms < 36e5) return `${(ms / 6e4).toFixed(1)}m`;
+  return `${(ms / 36e5).toFixed(1)}h`;
+}
+function formatSeconds(seconds) {
+  if (seconds < 60) return `${seconds}s`;
+  if (seconds < 3600) return `${(seconds / 60).toFixed(1)}m`;
+  if (seconds < 86400) return `${(seconds / 3600).toFixed(1)}h`;
+  return `${(seconds / 86400).toFixed(1)}d`;
+}
+function isValidDuration(value) {
+  return /^\d+(?:\.\d+)?\s*[smhdwMy]$/.test(value);
+}
+function isValidSize(value) {
+  return /^\d+(?:\.\d+)?\s*(B|KB|MB|GB|TB)$/i.test(value);
+}
+
 exports.AutoSyncPatternSchema = AutoSyncPatternSchema;
 exports.BUILT_IN_TYPES = BUILT_IN_TYPES;
 exports.CODEX_URI_PREFIX = CODEX_URI_PREFIX;
@@ -5034,7 +5216,10 @@ exports.evaluatePaths = evaluatePaths;
 exports.evaluatePatterns = evaluatePatterns;
 exports.evaluatePermission = evaluatePermission;
 exports.evaluatePermissions = evaluatePermissions;
+exports.expandEnvVars = expandEnvVars;
+exports.expandEnvVarsInConfig = expandEnvVarsInConfig;
 exports.extendType = extendType;
+exports.extractEnvVarNames = extractEnvVarNames;
 exports.extractOrgFromRepoName = extractOrgFromRepoName;
 exports.extractRawFrontmatter = extractRawFrontmatter;
 exports.filterByPatterns = filterByPatterns;
@@ -5042,7 +5227,10 @@ exports.filterByPermission = filterByPermission;
 exports.filterPlanOperations = filterPlanOperations;
 exports.filterSyncablePaths = filterSyncablePaths;
 exports.findLegacyReferences = findLegacyReferences;
+exports.formatBytes = formatBytes2;
+exports.formatDuration = formatDuration;
 exports.formatPlanSummary = formatPlanSummary;
+exports.formatSeconds = formatSeconds;
 exports.generateMigrationReport = generateMigrationReport;
 exports.generateReferenceMigrationSummary = generateReferenceMigrationSummary;
 exports.getBuiltInType = getBuiltInType;
@@ -5066,6 +5254,7 @@ exports.getRelativeCachePath = getRelativeCachePath;
 exports.getRemainingTtl = getRemainingTtl;
 exports.getTargetRepos = getTargetRepos;
 exports.hasContentChanged = hasContentChanged;
+exports.hasEnvVars = hasEnvVars;
 exports.hasFrontmatter = hasFrontmatter;
 exports.hasLegacyReferences = hasLegacyReferences;
 exports.hasPermissionLevel = hasPermission;
@@ -5077,6 +5266,9 @@ exports.isLegacyConfig = isLegacyConfig;
 exports.isLegacyReference = isLegacyReference;
 exports.isModernConfig = isModernConfig;
 exports.isPermissionAllowed = isAllowed;
+exports.isUnifiedConfig = isUnifiedConfig;
+exports.isValidDuration = isValidDuration;
+exports.isValidSize = isValidSize;
 exports.isValidUri = isValidUri;
 exports.levelGrants = levelGrants;
 exports.loadConfig = loadConfig;
@@ -5092,9 +5284,13 @@ exports.migrateFileReferences = migrateFileReferences;
 exports.minLevel = minLevel;
 exports.needsMigration = needsMigration;
 exports.parseCustomDestination = parseCustomDestination;
+exports.parseDuration = parseDuration;
 exports.parseMetadata = parseMetadata;
 exports.parseReference = parseReference;
+exports.parseSize = parseSize;
 exports.parseTtl = parseTtl;
+exports.readCodexConfig = readCodexConfig;
+exports.readUnifiedConfig = readUnifiedConfig;
 exports.resolveOrganization = resolveOrganization;
 exports.resolveReference = resolveReference;
 exports.resolveReferences = resolveReferences;