@uipath/solutionpackager-tool-core 0.0.26

package/dist/i18n/locales/zh-TW.js

@@ -0,0 +1,38 @@
+const zh_TW = {
+    toolCore: {
+        errors: {
+            internal: "Internal error: {message}",
+            fileNotFound: "File not found: {path}",
+            fileReadFailed: "Failed to read file: {path}",
+            fileWriteFailed: "Failed to write file: {path}",
+            directoryNotFound: "Directory not found: {path}",
+            invalidPath: "{path} is not a valid path",
+            operationCanceled: "Operation was canceled",
+            invalidParameter: "Invalid parameter: {parameter}"
+        },
+        progress: {
+            copying: "Copying files...",
+            building: "Building project...",
+            packaging: "Creating package...",
+            validating: "Validating...",
+            analyzing: "Analyzing...",
+            restoring: "Restoring dependencies..."
+        },
+        validation: {
+            requiredField: "{field} is required",
+            invalidValue: "Invalid value for {field}",
+            pathNotFound: "Path not found: {path}",
+            fileRequired: "File is required: {path}",
+            directoryRequired: "Directory is required: {path}"
+        },
+        info: {
+            operationComplete: "Operation completed successfully",
+            filesProcessed: {
+                zero: "No files processed",
+                one: "{count} file processed",
+                other: "{count} files processed"
+            }
+        }
+    }
+};
+export { zh_TW };

package/dist/i18n/locales/zu.d.ts

@@ -0,0 +1,37 @@
+export declare const zu: {
+    toolCore: {
+        errors: {
+            internal: string;
+            fileNotFound: string;
+            fileReadFailed: string;
+            fileWriteFailed: string;
+            directoryNotFound: string;
+            invalidPath: string;
+            operationCanceled: string;
+            invalidParameter: string;
+        };
+        progress: {
+            copying: string;
+            building: string;
+            packaging: string;
+            validating: string;
+            analyzing: string;
+            restoring: string;
+        };
+        validation: {
+            requiredField: string;
+            invalidValue: string;
+            pathNotFound: string;
+            fileRequired: string;
+            directoryRequired: string;
+        };
+        info: {
+            operationComplete: string;
+            filesProcessed: {
+                zero: string;
+                one: string;
+                other: string;
+            };
+        };
+    };
+};

package/dist/i18n/locales/zu.js

@@ -0,0 +1,38 @@
+const zu = {
+    toolCore: {
+        errors: {
+            internal: "Internal error: {message}",
+            fileNotFound: "File not found: {path}",
+            fileReadFailed: "Failed to read file: {path}",
+            fileWriteFailed: "Failed to write file: {path}",
+            directoryNotFound: "Directory not found: {path}",
+            invalidPath: "{path} is not a valid path",
+            operationCanceled: "Operation was canceled",
+            invalidParameter: "Invalid parameter: {parameter}"
+        },
+        progress: {
+            copying: "Copying files...",
+            building: "Building project...",
+            packaging: "Creating package...",
+            validating: "Validating...",
+            analyzing: "Analyzing...",
+            restoring: "Restoring dependencies..."
+        },
+        validation: {
+            requiredField: "{field} is required",
+            invalidValue: "Invalid value for {field}",
+            pathNotFound: "Path not found: {path}",
+            fileRequired: "File is required: {path}",
+            directoryRequired: "Directory is required: {path}"
+        },
+        info: {
+            operationComplete: "Operation completed successfully",
+            filesProcessed: {
+                zero: "No files processed",
+                one: "{count} file processed",
+                other: "{count} files processed"
+            }
+        }
+    }
+};
+export { zu };

package/dist/i18n/translation-service.d.ts

@@ -0,0 +1,61 @@
+/**
+ * TranslationService - Singleton service for managing translations.
+ * Configured once with a locale and provides translation methods.
+ */
+import type { InterpolationParams } from "./i18n-manager.js";
+/**
+ * Singleton service for translation management.
+ * Configure once at application startup with setLocale(), then use t() to translate.
+ */
+export declare class TranslationService {
+    private static instance;
+    private currentLocale;
+    /**
+     * Private constructor - use getInstance() instead
+     */
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): TranslationService;
+    /**
+     * Configure the locale for all translations
+     * @param locale - Locale code (e.g., 'en', 'fr', 'de', 'es-MX', 'pt-BR')
+     */
+    setLocale(locale: string): void;
+    /**
+     * Get the currently configured locale
+     */
+    getLocale(): string;
+    /**
+     * Translate a key to a localized string using the configured locale
+     * @param key - Translation key in dot notation (e.g., 'toolCore.errors.fileNotFound')
+     * @param params - Optional interpolation parameters for {placeholder} replacement
+     * @returns Translated and interpolated string
+     */
+    t(key: string, params?: InterpolationParams): string;
+    /**
+     * Translate a key with a specific locale override
+     * @param key - Translation key
+     * @param locale - Locale override
+     * @param params - Optional interpolation parameters
+     * @returns Translated string
+     */
+    tLocale(key: string, locale: string, params?: InterpolationParams): string;
+    /**
+     * Check if a translation key exists
+     * @param key - Translation key to check
+     * @returns True if key exists
+     */
+    has(key: string): boolean;
+    /**
+     * Get all available locales
+     * @returns Array of locale codes
+     */
+    getAvailableLocales(): string[];
+}
+/**
+ * Singleton instance of the TranslationService for convenient access.
+ * Use translate.t("key") to translate strings.
+ */
+export declare const translate: TranslationService;

package/dist/i18n/translation-service.js

@@ -0,0 +1,29 @@
+import { I18nManager } from "./i18n-manager.js";
+class TranslationService {
+    static instance;
+    currentLocale = "en";
+    static getInstance() {
+        if (!TranslationService.instance) TranslationService.instance = new TranslationService();
+        return TranslationService.instance;
+    }
+    setLocale(locale) {
+        this.currentLocale = I18nManager.setLocale(locale);
+    }
+    getLocale() {
+        return this.currentLocale;
+    }
+    t(key, params) {
+        return I18nManager.t(key, params, this.currentLocale);
+    }
+    tLocale(key, locale, params) {
+        return I18nManager.t(key, params, locale);
+    }
+    has(key) {
+        return I18nManager.has(key, this.currentLocale);
+    }
+    getAvailableLocales() {
+        return I18nManager.getAvailableLocales();
+    }
+}
+const translate = TranslationService.getInstance();
+export { TranslationService, translate };

package/dist/i18n/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Type utilities for extracting translation keys from nested objects
+ * and validating interpolation parameters at compile time.
+ */
+/**
+ * Recursively extract dot-notation paths from a nested object type.
+ * Converts { foo: { bar: string } } → 'foo' | 'foo.bar'
+ */
+type PathImpl<T, K extends keyof T> = K extends string ? T[K] extends Record<string, unknown> ? T[K] extends ArrayLike<unknown> ? K | `${K}.${PathImpl<T[K], Exclude<keyof T[K], keyof unknown[]>>}` : K | `${K}.${PathImpl<T[K], keyof T[K]>}` : K : never;
+/**
+ * Extract all possible dot-notation paths from an object type.
+ */
+export type Path<T> = PathImpl<T, keyof T> | keyof T;
+/**
+ * Get the value type at a specific dot-notation path in an object type.
+ * Example: Get<{ foo: { bar: string } }, 'foo.bar'> → string
+ */
+export type Get<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? Get<T[K], Rest> : never : P extends keyof T ? T[P] : never;
+/**
+ * Extract parameter names from a string containing {param} placeholders.
+ * Example: ExtractParams<'Hello {name}, you are {age} years old'> → 'name' | 'age'
+ */
+type ExtractParams<T extends string> = T extends `${string}{${infer Param}}${infer Rest}` ? Param | ExtractParams<Rest> : never;
+/**
+ * Create a parameter object type from extracted parameter names.
+ * If no parameters exist, returns an empty object type.
+ */
+export type ParamsFromKeys<Keys extends string> = [Keys] extends [never] ? Record<string, never> : {
+    [K in Keys]: string | number;
+};
+/**
+ * Extract and validate interpolation parameters for a translation key.
+ * Returns a Record type with required parameters if any exist.
+ */
+export type TranslationParams<T extends Record<string, unknown>, K extends Path<T> & string> = Get<T, K> extends string ? ParamsFromKeys<ExtractParams<Get<T, K>>> : Record<string, never>;
+/**
+ * Plural form keys for languages with multiple plural forms.
+ * Most languages use zero/one/other, some use more forms.
+ */
+export interface PluralForms {
+    zero?: string;
+    one?: string;
+    two?: string;
+    few?: string;
+    many?: string;
+    other: string;
+}
+/**
+ * Translation value can be a simple string or plural forms.
+ */
+export type TranslationValue = string | PluralForms;
+/**
+ * Check if a translation value has plural forms.
+ */
+export declare function isPluralForm(value: TranslationValue): value is PluralForms;
+/**
+ * Select the appropriate plural form based on count.
+ * Uses simplified plural rules suitable for most European and Asian languages.
+ */
+export declare function selectPluralForm(forms: PluralForms, count: number): string;
+export {};

package/dist/i18n/types.js

@@ -0,0 +1,20 @@
+function isPluralForm(value) {
+    return "object" == typeof value && null !== value && "other" in value;
+}
+function selectPluralForm(forms, count) {
+    if (0 === count && void 0 !== forms.zero) return forms.zero;
+    if (1 === count && void 0 !== forms.one) return forms.one;
+    if (2 === count && void 0 !== forms.two) return forms.two;
+    if (void 0 !== forms.few) {
+        const mod10 = count % 10;
+        const mod100 = count % 100;
+        if (mod10 >= 2 && mod10 <= 4 && (mod100 < 10 || mod100 >= 20)) return forms.few;
+    }
+    if (void 0 !== forms.many) {
+        const mod10 = count % 10;
+        const mod100 = count % 100;
+        if (0 === count || 0 === mod10 && 0 !== mod100 || mod10 >= 5 && mod10 <= 9 || mod100 >= 11 && mod100 <= 14) return forms.many;
+    }
+    return forms.other;
+}
+export { isPluralForm, selectPluralForm };

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./filesystem/index.js";
+export * from "./i18n/index.js";
+export * from "./models/index.js";
+export * from "./package-descriptor/index.js";
+export * from "./services/index.js";

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./filesystem/index.js";
+export * from "./i18n/index.js";
+export * from "./models/index.js";
+export * from "./package-descriptor/index.js";
+export * from "./services/index.js";

package/dist/models/build-configuration.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Build configuration enum
+ */
+export declare enum BuildConfiguration {
+    Debug = "Debug",
+    Release = "Release"
+}

package/dist/models/build-configuration.js

@@ -0,0 +1,6 @@
+var build_configuration_BuildConfiguration = /*#__PURE__*/ function(BuildConfiguration) {
+    BuildConfiguration["Debug"] = "Debug";
+    BuildConfiguration["Release"] = "Release";
+    return BuildConfiguration;
+}({});
+export { build_configuration_BuildConfiguration as BuildConfiguration };

package/dist/models/connection-info.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Strips the origin from a URL, returning only the pathname with trailing slashes removed.
+ * This ensures fetch calls use relative URLs to avoid CORS issues in the browser.
+ */
+export declare function toRelativeUrl(url: string): string;
+/**
+ * Connection information for UiPath Cloud/Orchestrator
+ */
+export interface ConnectionInfo {
+    /**
+     * The URL of the UiPath Cloud instance
+     */
+    cloudUrl?: string;
+    /**
+     * Access token for authentication
+     */
+    accessToken?: string;
+    /**
+     * Tenant identifier
+     */
+    tenantId?: string;
+    /**
+     * Folder identifier
+     */
+    folderId?: string;
+}

package/dist/models/connection-info.js

@@ -0,0 +1,9 @@
+function toRelativeUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.pathname.replace(/\/+$/, "");
+    } catch  {
+        return url.replace(/\/+$/, "");
+    }
+}
+export { toRelativeUrl };

package/dist/models/index.d.ts

@@ -0,0 +1,18 @@
+export { BuildConfiguration } from "./build-configuration.js";
+export type { ConnectionInfo } from "./connection-info.js";
+export { toRelativeUrl } from "./connection-info.js";
+export { LogLevel, LogMessage } from "./log-message.js";
+export { NugetConstants } from "./nuget-constants.js";
+export type { NugetFeedModel } from "./nuget-feed-model.js";
+export type { NugetDependency, NugetPackageInfo, } from "./nuget-package-info.js";
+export type { PackageInfo } from "./package-info.js";
+export type { IProjectBuildOptions, IProjectOptions, IProjectPackOptions, IProjectRestoreOptions, IProjectValidateOptions, } from "./project-options.js";
+export type { ProjectType } from "./project-type.js";
+export { ProjectTypes } from "./project-type.js";
+export type { ISolutionBuildOptions, ISolutionOptions, ISolutionPackOptions, ISolutionRestoreOptions, ISolutionValidateOptions, } from "./solution-options.js";
+export { TargetFramework } from "./target-frameworks.js";
+export type { ToolErrorCode } from "./tool-error-code.js";
+export { ToolErrorCodes } from "./tool-error-code.js";
+export { ToolResult } from "./tool-result.js";
+export type { UiPathProject } from "./uipath-project.js";
+export type { UiPathSolution } from "./uipath-solution.js";

package/dist/models/index.js

@@ -0,0 +1,8 @@
+export { BuildConfiguration } from "./build-configuration.js";
+export { toRelativeUrl } from "./connection-info.js";
+export { LogLevel, LogMessage } from "./log-message.js";
+export { NugetConstants } from "./nuget-constants.js";
+export { ProjectTypes } from "./project-type.js";
+export { TargetFramework } from "./target-frameworks.js";
+export { ToolErrorCodes } from "./tool-error-code.js";
+export { ToolResult } from "./tool-result.js";

package/dist/models/log-message.d.ts

@@ -0,0 +1,28 @@
+export declare enum LogLevel {
+    Debug = "Debug",
+    Info = "Information",
+    Warn = "Warning",
+    Error = "Error"
+}
+export declare class LogMessage {
+    message: string;
+    logLevel: LogLevel;
+    source?: string;
+    sourceTarget?: string;
+    progress?: number;
+    code?: string;
+    filePath?: string;
+    line?: string;
+    id?: string;
+    readonly timestamp: Date;
+    constructor(message: string, logLevel: LogLevel, options?: {
+        source?: string;
+        sourceTarget?: string;
+        progress?: number;
+        code?: string;
+        filePath?: string;
+        line?: string;
+        id?: string;
+    });
+    toFormattedString(): string;
+}

package/dist/models/log-message.js

@@ -0,0 +1,48 @@
+var log_message_LogLevel = /*#__PURE__*/ function(LogLevel) {
+    LogLevel["Debug"] = "Debug";
+    LogLevel["Info"] = "Information";
+    LogLevel["Warn"] = "Warning";
+    LogLevel["Error"] = "Error";
+    return LogLevel;
+}({});
+class LogMessage {
+    message;
+    logLevel;
+    source;
+    sourceTarget;
+    progress;
+    code;
+    filePath;
+    line;
+    id;
+    timestamp;
+    constructor(message, logLevel, options){
+        this.message = message;
+        this.logLevel = logLevel;
+        this.source = options?.source;
+        this.sourceTarget = options?.sourceTarget;
+        this.progress = options?.progress;
+        this.code = options?.code;
+        this.filePath = options?.filePath;
+        this.line = options?.line;
+        this.id = options?.id;
+        this.timestamp = new Date();
+    }
+    toFormattedString() {
+        const parts = [];
+        parts.push(`[${this.timestamp.toISOString()}]`);
+        parts.push(`[${String(this.logLevel).toUpperCase()}]`);
+        if (this.source) parts.push(`[${this.source}]`);
+        if (this.sourceTarget) parts.push(`[${this.sourceTarget}]`);
+        const locationParts = [];
+        if (this.filePath) locationParts.push(this.filePath);
+        if (this.line) locationParts.push(`Line:${this.line}`);
+        if (this.id) locationParts.push(`Id:${this.id}`);
+        if (locationParts.length > 0) parts.push(`(${locationParts.join("")})`);
+        if (this.code) parts.push(`[${this.code}]`);
+        if (this.progress || 0 === this.progress) parts.push(`${this.progress}%`);
+        parts.push(this.message);
+        return parts.join(" ");
+    }
+}
+export { LogMessage, log_message_LogLevel as LogLevel };

package/dist/models/nuget-constants.d.ts

@@ -0,0 +1,34 @@
+/**
+ * NuGet packaging constants
+ * Matches the .NET NugetUtils constants
+ */
+export declare const NugetConstants: {
+    /**
+     * Output folder name for build artifacts
+     */
+    readonly OutputFolderName: "bundle";
+    /**
+     * Content folder name within the output
+     */
+    readonly ContentFolderName: "content";
+    /**
+     * Operate file name
+     */
+    readonly OperateFileName: "operate.json";
+    /**
+     * Entry points file name
+     */
+    readonly EntryPointsFileName: "entry-points.json";
+    /**
+     * Package descriptor file name
+     */
+    readonly PackageDescriptorFileName: "package-descriptor.json";
+    /**
+     * Bindings v2 file name
+     */
+    readonly BindingsV2FileName: "bindings_v2.json";
+    /**
+     * Bindings file identifier in package descriptor
+     */
+    readonly BindingsFileId: "bindings.json";
+};

package/dist/models/nuget-constants.js

@@ -0,0 +1,10 @@
+const NugetConstants = {
+    OutputFolderName: "bundle",
+    ContentFolderName: "content",
+    OperateFileName: "operate.json",
+    EntryPointsFileName: "entry-points.json",
+    PackageDescriptorFileName: "package-descriptor.json",
+    BindingsV2FileName: "bindings_v2.json",
+    BindingsFileId: "bindings.json"
+};
+export { NugetConstants };

package/dist/models/nuget-feed-model.d.ts

@@ -0,0 +1,25 @@
+/**
+ * NuGet feed configuration model
+ */
+export interface NugetFeedModel {
+    /**
+     * NuGet feed URL
+     */
+    url: string;
+    /**
+     * Access token for authentication
+     */
+    accessToken?: string;
+    /**
+     * API key for authentication
+     */
+    apiKey?: string;
+    /**
+     * Application ID for authentication
+     */
+    appId?: string;
+    /**
+     * Application secret for authentication
+     */
+    appSecret?: string;
+}

package/dist/models/nuget-package-info.d.ts

@@ -0,0 +1,63 @@
+import type { PackageInfo } from "./package-info.js";
+/**
+ * Dependency information for a NuGet package
+ */
+export interface NugetDependency {
+    /**
+     * Package ID of the dependency
+     */
+    id: string;
+    /**
+     * Version or version range of the dependency
+     */
+    version: string;
+}
+/**
+ * NuGet-specific package information extending base package info
+ */
+export interface NugetPackageInfo extends PackageInfo {
+    /**
+     * URL to the package icon
+     */
+    iconUrl?: string;
+    /**
+     * Project homepage URL
+     */
+    projectUrl?: string;
+    /**
+     * Package dependencies
+     */
+    dependencies?: NugetDependency[];
+    /**
+     * Package tags (space-separated) for NuGet metadata
+     */
+    tags?: string;
+    /**
+     * Copyright information
+     */
+    copyright?: string;
+    /**
+     * URL to the license
+     */
+    licenseUrl?: string;
+    /**
+     * Whether the package requires license acceptance
+     */
+    requireLicenseAcceptance?: boolean;
+    /**
+     * Repository type (e.g., "git")
+     */
+    repositoryType?: string;
+    /**
+     * Repository URL
+     */
+    repositoryUrl?: string;
+    /**
+     * Repository branch name
+     */
+    repositoryBranch?: string;
+    /**
+     * Repository commit hash
+     */
+    repositoryCommit?: string;
+}

package/dist/models/package-info.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Package information for a UiPath solution package
+ */
+export interface PackageInfo {
+    /**
+     * Package id
+     */
+    id: string;
+    /**
+     * Package version
+     */
+    version: string;
+    /**
+     * Package title (display name)
+     */
+    title?: string;
+    /**
+     * Package author
+     */
+    author?: string;
+    /**
+     * Package description
+     */
+    description?: string;
+    /**
+     * Release notes for this package version
+     */
+    releaseNotes?: string;
+}