@fulmenhq/tsfulmen 0.3.3 → 0.4.1

package/dist/crucible/fulpack/index.js

@@ -1,27 +1,4 @@
-// src/crucible/fulpack/types.ts
-var ArchiveFormat = /* @__PURE__ */ ((ArchiveFormat2) => {
-  ArchiveFormat2["TAR"] = "tar";
-  ArchiveFormat2["TAR_GZ"] = "tar.gz";
-  ArchiveFormat2["ZIP"] = "zip";
-  ArchiveFormat2["GZIP"] = "gzip";
-  return ArchiveFormat2;
-})(ArchiveFormat || {});
-var EntryType = /* @__PURE__ */ ((EntryType2) => {
-  EntryType2["FILE"] = "file";
-  EntryType2["DIRECTORY"] = "directory";
-  EntryType2["SYMLINK"] = "symlink";
-  return EntryType2;
-})(EntryType || {});
-var Operation = /* @__PURE__ */ ((Operation2) => {
-  Operation2["CREATE"] = "create";
-  Operation2["EXTRACT"] = "extract";
-  Operation2["SCAN"] = "scan";
-  Operation2["VERIFY"] = "verify";
-  Operation2["INFO"] = "info";
-  return Operation2;
-})(Operation || {});
-var FULPACK_VERSION = "v1.0.0";
-
-export { ArchiveFormat, EntryType, FULPACK_VERSION, Operation };
+export { ArchiveFormat, EntryType, FULPACK_VERSION, Operation } from '../../chunk-PQ6TKPUN.js';
+import '../../chunk-UP2VWCW5.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/crucible/fulpack/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/crucible/fulpack/types.ts"],"names":["ArchiveFormat","EntryType","Operation"],"mappings":";AAqBO,IAAK,aAAA,qBAAAA,cAAAA,KAAL;AAEL,EAAAA,eAAA,KAAA,CAAA,GAAM,KAAA;AAEN,EAAAA,eAAA,QAAA,CAAA,GAAS,QAAA;AAET,EAAAA,eAAA,KAAA,CAAA,GAAM,KAAA;AAEN,EAAAA,eAAA,MAAA,CAAA,GAAO,MAAA;AARG,EAAA,OAAAA,cAAAA;AAAA,CAAA,EAAA,aAAA,IAAA,EAAA;AAeL,IAAK,SAAA,qBAAAC,UAAAA,KAAL;AAEL,EAAAA,WAAA,MAAA,CAAA,GAAO,MAAA;AAEP,EAAAA,WAAA,WAAA,CAAA,GAAY,WAAA;AAEZ,EAAAA,WAAA,SAAA,CAAA,GAAU,SAAA;AANA,EAAA,OAAAA,UAAAA;AAAA,CAAA,EAAA,SAAA,IAAA,EAAA;AAaL,IAAK,SAAA,qBAAAC,UAAAA,KAAL;AAEL,EAAAA,WAAA,QAAA,CAAA,GAAS,QAAA;AAET,EAAAA,WAAA,SAAA,CAAA,GAAU,SAAA;AAEV,EAAAA,WAAA,MAAA,CAAA,GAAO,MAAA;AAEP,EAAAA,WAAA,QAAA,CAAA,GAAS,QAAA;AAET,EAAAA,WAAA,MAAA,CAAA,GAAO,MAAA;AAVG,EAAA,OAAAA,UAAAA;AAAA,CAAA,EAAA,SAAA,IAAA,EAAA;AAsNL,IAAM,eAAA,GAAkB","file":"index.js","sourcesContent":["/**\n * Fulpack Types - Generated from Crucible schemas.\n *\n * This file is AUTO-GENERATED from the Fulpack module specification.\n * DO NOT EDIT MANUALLY - changes will be overwritten.\n *\n * Schema Version: v1.0.0\n * Last Reviewed: 2025-11-12\n * Source: schemas/library/fulpack/v1.0.0/\n *\n * See: https://github.com/fulmenhq/crucible/blob/main/docs/standards/library/modules/fulpack.md\n */\n\n// ============================================================================\n// Enums (TypeScript Enums)\n// ============================================================================\n\n/**\n * ArchiveFormat enum\n * @see schemas/taxonomy/library/fulpack/archive-formats/v1.0.0/formats.yaml\n */\nexport enum ArchiveFormat {\n  /** POSIX tar archive (uncompressed) */\n  TAR = \"tar\",\n  /** POSIX tar archive with gzip compression */\n  TAR_GZ = \"tar.gz\",\n  /** ZIP archive with deflate compression */\n  ZIP = \"zip\",\n  /** GZIP compressed single file */\n  GZIP = \"gzip\",\n}\n\n/**\n * EntryType enum\n * @see schemas/taxonomy/library/fulpack/entry-types/v1.0.0/types.yaml\n */\nexport enum EntryType {\n  /** Normal file with data */\n  FILE = \"file\",\n  /** Directory/folder entry */\n  DIRECTORY = \"directory\",\n  /** Symbolic link to another entry */\n  SYMLINK = \"symlink\",\n}\n\n/**\n * Operation enum\n * @see schemas/taxonomy/library/fulpack/operations/v1.0.0/operations.yaml\n */\nexport enum Operation {\n  /** Create new archive from source files/directories */\n  CREATE = \"create\",\n  /** Extract archive contents to destination */\n  EXTRACT = \"extract\",\n  /** List archive entries (for Pathfinder integration) */\n  SCAN = \"scan\",\n  /** Validate archive integrity and checksums */\n  VERIFY = \"verify\",\n  /** Get archive metadata without extraction */\n  INFO = \"info\",\n}\n\n// ============================================================================\n// Structured Error Types\n// ============================================================================\n\n/**\n * Structured error context for fulpack operations.\n * Enables programmatic error handling and observability.\n *\n * @see docs/standards/library/modules/fulpack.md\n */\nexport interface FulpackError {\n  /**\n   * Canonical error code for programmatic handling.\n   * Examples: \"PATH_TRAVERSAL\", \"DECOMPRESSION_BOMB\", \"ABSOLUTE_PATH\", \"SYMLINK_ESCAPE\"\n   */\n  readonly code: string;\n\n  /**\n   * Human-readable error message describing what went wrong.\n   */\n  readonly message: string;\n\n  /**\n   * Operation that generated this error.\n   */\n  readonly operation: Operation;\n\n  /**\n   * Entry path that caused the error (if applicable).\n   * Example: \"../../../etc/passwd\"\n   */\n  readonly path?: string;\n\n  /**\n   * Archive file path being processed.\n   */\n  readonly archive?: string;\n\n  /**\n   * Source file path for create operations.\n   */\n  readonly source?: string;\n\n  /**\n   * Additional structured context for debugging and telemetry.\n   */\n  readonly details?: {\n    /** Entry index in archive (0-based) */\n    readonly entry_index?: number;\n    /** Compression ratio that triggered bomb detection */\n    readonly compression_ratio?: number;\n    /** Actual decompressed size in bytes */\n    readonly actual_size?: number;\n    /** Maximum allowed size in bytes */\n    readonly max_size?: number;\n    /** Maximum allowed entries */\n    readonly max_entries?: number;\n    /** Actual entry count */\n    readonly entry_count?: number;\n    /** Additional context (extensible) */\n    readonly [key: string]: unknown;\n  };\n}\n\n// ============================================================================\n// Data Structures (Interfaces)\n// ============================================================================\n\n/**\n * Metadata about an archive file\n * @see schemas/library/fulpack/v1.0.0/archive-info.schema.json\n */\nexport interface ArchiveInfo {\n  readonly format: \"tar\" | \"tar.gz\" | \"zip\" | \"gzip\"; // Archive format from archive-formats taxonomy\n  readonly entry_count: number; // Total number of entries in the archive\n  readonly total_size: number; // Total uncompressed size in bytes\n  readonly compressed_size: number; // Compressed archive file size in bytes\n  readonly compression?: \"gzip\" | \"deflate\" | \"none\"; // Compression algorithm used\n  readonly compression_ratio?: number; // Compression ratio (total_size / compressed_size)\n  readonly has_checksums?: boolean; // Whether the archive contains checksums\n  readonly checksum_algorithm?: \"xxh3-128\" | \"sha256\" | \"sha512\" | \"sha1\" | \"md5\"; // Checksum algorithm used from fulhash module (xxh3-128 and sha256 are standard, others may require optional extensions)\n  readonly created?: string; // Archive creation timestamp (ISO 8601 format)\n}\n\n/**\n * Metadata for a single archive entry (returned by scan operation)\n * @see schemas/library/fulpack/v1.0.0/archive-entry.schema.json\n */\nexport interface ArchiveEntry {\n  readonly path: string; // Normalized entry path within archive\n  readonly type: \"file\" | \"directory\" | \"symlink\"; // Entry type from entry-types taxonomy\n  readonly size: number; // Uncompressed size in bytes\n  readonly compressed_size?: number; // Compressed size in bytes (if available)\n  readonly modified?: string; // Modification timestamp (ISO 8601 format)\n  readonly checksum?: string; // SHA-256 checksum (64 hex characters)\n  readonly mode?: string; // Unix file permissions (octal string, e.g., '0644')\n  readonly symlink_target?: string | null; // Target path if type is symlink, null otherwise\n}\n\n/**\n * Complete archive table of contents (for large archives and caching)\n * @see schemas/library/fulpack/v1.0.0/archive-manifest.schema.json\n */\nexport interface ArchiveManifest {\n  readonly format: \"tar\" | \"tar.gz\" | \"zip\" | \"gzip\"; // Archive format from archive-formats taxonomy\n  readonly version: string; // Manifest schema version (semantic versioning)\n  readonly generated: string; // Manifest generation timestamp (ISO 8601 format)\n  readonly entry_count: number; // Total number of entries in manifest\n  readonly entries: unknown[]; // Array of archive entries\n  readonly total_size?: number; // Total uncompressed size in bytes\n  readonly compressed_size?: number; // Compressed archive file size in bytes\n  readonly index?: Record<string, unknown>; // Optional searchable index for fast lookups\n}\n\n/**\n * Result of archive integrity verification (from verify operation)\n * @see schemas/library/fulpack/v1.0.0/validation-result.schema.json\n */\nexport interface ValidationResult {\n  readonly valid: boolean; // Whether the archive is valid and intact\n  readonly errors: FulpackError[]; // Array of validation errors (empty if valid)\n  readonly warnings: string[]; // Array of non-critical warnings (e.g., missing checksums)\n  readonly entry_count: number; // Number of entries validated\n  readonly checksums_verified?: number; // Number of checksums successfully verified\n  readonly checks_performed?: (\n    | \"structure_valid\"\n    | \"checksums_verified\"\n    | \"no_path_traversal\"\n    | \"no_decompression_bomb\"\n    | \"symlinks_safe\"\n  )[]; // List of security and integrity checks performed\n}\n\n/**\n * Result of archive extraction operation\n * @see schemas/library/fulpack/v1.0.0/extract-result.schema.json\n */\nexport interface ExtractResult {\n  readonly extracted_count: number; // Number of entries successfully extracted\n  readonly skipped_count: number; // Number of entries skipped (e.g., already exists)\n  readonly error_count: number; // Number of entries that failed to extract\n  readonly errors?: FulpackError[]; // Array of error messages for failed extractions\n  readonly warnings?: string[]; // Array of warning messages (e.g., skipped files)\n  readonly checksums_verified?: number; // Number of checksums successfully verified during extraction\n  readonly total_bytes?: number; // Total bytes extracted\n}\n\n// ============================================================================\n// Options (Partial Interfaces)\n// ============================================================================\n\n/**\n * Options for archive creation operation\n * @see schemas/library/fulpack/v1.0.0/create-options.schema.json\n *\n * All fields are optional. Use when calling functions.\n */\nexport interface CreateOptions {\n  compression_level?: number; // Compression level (1=fastest, 9=best compression, format-dependent)\n  include_patterns?: string[]; // Glob patterns for files to include (e.g., ['**/*.py', '**/*.md'])\n  exclude_patterns?: string[]; // Glob patterns for files to exclude (e.g., ['**/__pycache__', '**/.git'])\n  checksum_algorithm?: \"xxh3-128\" | \"sha256\" | \"sha512\" | \"sha1\" | \"md5\"; // Checksum algorithm for entry verification (xxh3-128 and sha256 are standard via fulhash module, others may require optional extensions)\n  preserve_permissions?: boolean; // Preserve Unix file permissions in archive\n  follow_symlinks?: boolean; // Follow symbolic links and archive their targets\n}\n\n/**\n * Options for archive extraction operation\n * @see schemas/library/fulpack/v1.0.0/extract-options.schema.json\n *\n * All fields are optional. Use when calling functions.\n */\nexport interface ExtractOptions {\n  overwrite?: \"error\" | \"skip\" | \"overwrite\"; // How to handle existing files (error=fail, skip=keep existing, overwrite=replace)\n  verify_checksums?: boolean; // Verify checksums during extraction if available\n  preserve_permissions?: boolean; // Preserve Unix file permissions from archive\n  include_patterns?: string[]; // Glob patterns for entries to extract (e.g., ['**/*.csv'])\n  max_size?: number; // Maximum total decompressed size in bytes (decompression bomb protection)\n  max_entries?: number; // Maximum number of entries to extract (decompression bomb protection)\n}\n\n/**\n * Options for archive scanning operation (for Pathfinder integration)\n * @see schemas/library/fulpack/v1.0.0/scan-options.schema.json\n *\n * All fields are optional. Use when calling functions.\n */\nexport interface ScanOptions {\n  include_metadata?: boolean; // Include metadata (size, checksum, modified timestamp) in results\n  entry_types?: (\"file\" | \"directory\" | \"symlink\")[]; // Filter entries by type (from entry-types taxonomy)\n  max_depth?: number | null; // Maximum depth for directory traversal (null = unlimited)\n  max_entries?: number; // Safety limit for maximum entries to return\n}\n\n// ============================================================================\n// Module Metadata\n// ============================================================================\n\n/**\n * Module version for compatibility checks.\n */\nexport const FULPACK_VERSION = \"v1.0.0\";\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}