@salesforce/packaging 0.1.20 → 1.0.2

package/lib/utils/packageUtils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.numberToDuration = exports.combineSaveErrors = exports.formatDate = exports.generatePackageAliasEntry = exports.getPackageAliasesFromId = exports.getPackageIdFromAlias = exports.getConfigPackageDirectory = exports.getPackageVersionNumber = exports.concatVersion = exports.getInClauseItemsCount = exports.queryWithInConditionChunking = exports.getPackageVersionStrings = exports.getHasMetadataRemoved = exports.getContainerOptions = exports.escapeInstallationKey = exports.getPackageVersionId = exports.massageErrorMessage = exports.applyErrorAction = exports.validateIdNoThrow = exports.getSourceApiVersion = exports.validateId = exports.BY_LABEL = exports.BY_PREFIX = exports.DEFAULT_PACKAGE_DIR = exports.POLL_INTERVAL_SECONDS = exports.SOQL_WHERE_CLAUSE_MAX_LENGTH = exports.INSTALL_URL_BASE = exports.VERSION_NUMBER_SEP = void 0;
+exports.copyDir = exports.zipDir = exports.numberToDuration = exports.combineSaveErrors = exports.generatePackageAliasEntry = exports.getPackageVersionNumber = exports.getPackageVersionStrings = exports.getContainerOptions = exports.escapeInstallationKey = exports.getPackageVersionId = exports.massageErrorMessage = exports.applyErrorAction = exports.validateIdNoThrow = exports.validateId = exports.uniqid = exports.BY_LABEL = exports.DEFAULT_PACKAGE_DIR = exports.POLL_INTERVAL_SECONDS = exports.INSTALL_URL_BASE = exports.VERSION_NUMBER_SEP = void 0;
 /*
  * Copyright (c) 2022, salesforce.com, inc.
  * All rights reserved.
@@ -8,9 +8,18 @@ exports.numberToDuration = exports.combineSaveErrors = exports.formatDate = expo
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 const os = require("os");
+const fs = require("fs");
+const path_1 = require("path");
+const stream_1 = require("stream");
+const util_1 = require("util");
+const crypto_1 = require("crypto");
+const util = require("util");
 const core_1 = require("@salesforce/core");
 const ts_types_1 = require("@salesforce/ts-types");
 const kit_1 = require("@salesforce/kit");
+const core_2 = require("@salesforce/core");
+const globby = require("globby");
+const JSZIP = require("jszip");
 core_1.Messages.importMessagesDirectory(__dirname);
 const messages = core_1.Messages.loadMessages('@salesforce/packaging', 'pkg_utils');
 exports.VERSION_NUMBER_SEP = '.';
@@ -35,7 +44,7 @@ const ID_REGISTRY = [
 ];
 exports.INSTALL_URL_BASE = new core_1.SfdcUrl('https://login.salesforce.com/packaging/installPackage.apexp?p0=');
 // https://developer.salesforce.com/docs/atlas.en-us.salesforce_app_limits_cheatsheet.meta/salesforce_app_limits_cheatsheet/salesforce_app_limits_platform_soslsoql.htm
-exports.SOQL_WHERE_CLAUSE_MAX_LENGTH = 4000;
+const SOQL_WHERE_CLAUSE_MAX_LENGTH = 4000;
 exports.POLL_INTERVAL_SECONDS = 30;
 exports.DEFAULT_PACKAGE_DIR = {
     path: '',
@@ -44,8 +53,29 @@ exports.DEFAULT_PACKAGE_DIR = {
     versionNumber: '0.1.0.NEXT',
     default: true,
 };
-exports.BY_PREFIX = (() => Object.fromEntries(ID_REGISTRY.map((id) => [id.prefix, { prefix: id.prefix, label: id.label }])))();
 exports.BY_LABEL = (() => Object.fromEntries(ID_REGISTRY.map((id) => [id.label.replace(/ /g, '_').toUpperCase(), { prefix: id.prefix, label: id.label }])))();
+/**
+ * A function to generate a unique id and return it in the context of a template, if supplied.
+ *
+ * A template is a string that can contain `${%s}` to be replaced with a unique id.
+ * If the template contains the "%s" placeholder, it will be replaced with the unique id otherwise the id will be appended to the template.
+ *
+ * @param options an object with the following properties:
+ * - template: a template string.
+ * - length: the length of the unique id as presented in hexadecimal.
+ */
+function uniqid(options) {
+    const uniqueString = (0, crypto_1.randomBytes)(Math.ceil((options?.length ?? 32) / 2.0))
+        .toString('hex')
+        .slice(0, options?.length ?? 32);
+    if (!options?.template) {
+        return uniqueString;
+    }
+    return options.template.includes('%s')
+        ? util.format(options.template, uniqueString)
+        : `${options.template}${uniqueString}`;
+}
+exports.uniqid = uniqid;
 function validateId(idObj, value) {
     if (!validateIdNoThrow(idObj, value)) {
         throw messages.createError('invalidIdOrAlias', [
@@ -56,10 +86,6 @@ function validateId(idObj, value) {
     }
 }
 exports.validateId = validateId;
-function getSourceApiVersion(project) {
-    return project?.getSfProjectJson().get('sourceApiVersion');
-}
-exports.getSourceApiVersion = getSourceApiVersion;
 function validateIdNoThrow(idObj, value) {
     if (!value || (value.length !== 15 && value.length !== 18)) {
         return false;
@@ -177,25 +203,6 @@ async function getContainerOptions(packageIds, connection) {
     return new Map();
 }
 exports.getContainerOptions = getContainerOptions;
-/**
- * Return the Package2Version.HasMetadataRemoved field value for the given Id (05i)
- *
- * @param packageVersionId package version ID (05i)
- * @param connection For tooling query
- */
-async function getHasMetadataRemoved(packageVersionId, connection) {
-    const query = `SELECT HasMetadataRemoved FROM Package2Version WHERE Id = '${packageVersionId}'`;
-    const queryResult = await connection.tooling.query(query);
-    if (!queryResult || queryResult.records === null || queryResult.records.length === 0) {
-        throw messages.createError('errorInvalidIdNoMatchingVersionId', [
-            exports.BY_LABEL.PACKAGE_VERSION_ID.label,
-            packageVersionId,
-            exports.BY_LABEL.PACKAGE_VERSION_ID.label,
-        ]);
-    }
-    return queryResult.records[0].HasMetadataRemoved;
-}
-exports.getHasMetadataRemoved = getHasMetadataRemoved;
 /**
  * Given a list of subscriber package version IDs (04t), return the associated version strings (e.g., Major.Minor.Patch.Build)
  *
@@ -240,7 +247,7 @@ async function queryWithInConditionChunking(query, items, replaceToken, connecti
         return records;
     }
     const whereClause = query.substring(query.toLowerCase().indexOf('where'), query.length);
-    const inClauseItemsMaxLength = exports.SOQL_WHERE_CLAUSE_MAX_LENGTH - whereClause.length - replaceToken.length;
+    const inClauseItemsMaxLength = SOQL_WHERE_CLAUSE_MAX_LENGTH - whereClause.length - replaceToken.length;
     let itemsQueried = 0;
     while (itemsQueried < items.length) {
         const chunkCount = getInClauseItemsCount(items, itemsQueried, inClauseItemsMaxLength);
@@ -263,7 +270,6 @@ async function queryWithInConditionChunking(query, items, replaceToken, connecti
     }
     return records;
 }
-exports.queryWithInConditionChunking = queryWithInConditionChunking;
 /**
  * Returns the number of items that can be included in a quoted comma-separated string (e.g., "'item1','item2'") not exceeding maxLength
  */
@@ -285,54 +291,17 @@ function getInClauseItemsCount(items, startIndex, maxLength) {
     }
     return includedCount;
 }
-exports.getInClauseItemsCount = getInClauseItemsCount;
 /**
  * Return a version string in Major.Minor.Patch.Build format, using 0 for any empty part
  */
 function concatVersion(major, minor, patch, build) {
     return [major, minor, patch, build].map((part) => (part ? `${part}` : '0')).join('.');
 }
-exports.concatVersion = concatVersion;
 function getPackageVersionNumber(package2VersionObj) {
     const version = concatVersion(package2VersionObj.MajorVersion, package2VersionObj.MinorVersion, package2VersionObj.PatchVersion, undefined);
     return version.slice(0, version.lastIndexOf('.'));
 }
 exports.getPackageVersionNumber = getPackageVersionNumber;
-// TODO: replace with sfProject.getPackageDirectoryWithProperty()
-function getConfigPackageDirectory(packageDirs, lookupProperty, lookupValue) {
-    return packageDirs?.find((pkgDir) => pkgDir[lookupProperty] === lookupValue);
-}
-exports.getConfigPackageDirectory = getConfigPackageDirectory;
-/**
- * Given a packageAlias, attempt to return the associated id from the config
- *
- * @param packageAlias string representing a package alias
- * @param project for obtaining the project config
- * @returns the associated id or the arg given.
- */
-// TODO: replace with SfProject.getPackageIdFromAlias()
-function getPackageIdFromAlias(packageAlias, project) {
-    const packageAliases = project.getSfProjectJson().getContents().packageAliases || {};
-    // return alias if it exists, otherwise return what was passed in
-    return packageAliases[packageAlias] || packageAlias;
-}
-exports.getPackageIdFromAlias = getPackageIdFromAlias;
-/**
- * Given a package id, attempt to return the associated aliases from the config
- *
- * @param packageId string representing a package id
- * @param project for obtaining the project config
- * @returns an array of alias for the given id.
- */
-// TODO: replace with SfProject.getAliasesFromPackageId()
-function getPackageAliasesFromId(packageId, project) {
-    const packageAliases = project?.getSfProjectJson().getContents().packageAliases || {};
-    // check for a matching alias
-    return Object.entries(packageAliases)
-        .filter((alias) => alias[1] === packageId)
-        .map((alias) => alias[0]);
-}
-exports.getPackageAliasesFromId = getPackageAliasesFromId;
 /**
  * Generate package alias json entry for this package version that can be written to sfdx-project.json
  *
@@ -346,7 +315,7 @@ exports.getPackageAliasesFromId = getPackageAliasesFromId;
  */
 // TODO: move sfProject
 async function generatePackageAliasEntry(connection, project, packageVersionId, packageVersionNumber, branch, packageId) {
-    const aliasForPackageId = getPackageAliasesFromId(packageId, project);
+    const aliasForPackageId = project.getAliasesFromPackageId(packageId);
     let packageName;
     if (aliasForPackageId?.length === 0) {
         const query = `SELECT Name FROM Package2 WHERE Id = '${packageId}'`;
@@ -362,11 +331,6 @@ async function generatePackageAliasEntry(connection, project, packageVersionId,
     return [packageAlias, packageVersionId];
 }
 exports.generatePackageAliasEntry = generatePackageAliasEntry;
-function formatDate(date) {
-    const pad = (num) => (num < 10 ? `0${num}` : `${num}`);
-    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
-}
-exports.formatDate = formatDate;
 function combineSaveErrors(sObject, crudOperation, errors) {
     const errorMessages = errors.map((error) => {
         const fieldsString = error.fields?.length > 0 ? `Fields: [${error.fields.join(', ')}]` : '';
@@ -385,4 +349,51 @@ function numberToDuration(duration, unit = kit_1.Duration.Unit.MILLISECONDS) {
     return (0, ts_types_1.isNumber)(duration) ? new kit_1.Duration(duration, unit) : duration;
 }
 exports.numberToDuration = numberToDuration;
+const pipeline = (0, util_1.promisify)(stream_1.pipeline);
+/**
+ * Zips directory to given zipfile.
+ *
+ * https://github.com/archiverjs/node-archiver
+ *
+ * @param dir to zip
+ * @param zipfile
+ */
+async function zipDir(dir, zipfile) {
+    const logger = core_2.Logger.childFromRoot('srcDevUtils#zipDir');
+    const timer = process.hrtime();
+    const globbyResult = await globby('**/*', { expandDirectories: true, cwd: dir });
+    const zip = new JSZIP();
+    // add files tp zip
+    for (const file of globbyResult) {
+        zip.file(file, fs.readFileSync((0, path_1.join)(dir, file)));
+    }
+    // write zip to file
+    const zipStream = zip.generateNodeStream({
+        type: 'nodebuffer',
+        streamFiles: true,
+        compression: 'DEFLATE',
+        compressionOptions: {
+            level: 3,
+        },
+    });
+    await pipeline(zipStream, fs.createWriteStream(zipfile));
+    const stat = fs.statSync(zipfile);
+    logger.debug(`${stat.size} bytes written to ${zipfile} in ${getElapsedTime(timer)}ms`);
+    return;
+}
+exports.zipDir = zipDir;
+function getElapsedTime(timer) {
+    const elapsed = process.hrtime(timer);
+    return (elapsed[0] * 1000 + elapsed[1] / 1000000).toFixed(3);
+}
+function copyDir(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+    entries.map((entry) => {
+        const srcPath = (0, path_1.join)(src, entry.name);
+        const destPath = (0, path_1.join)(dest, entry.name);
+        return entry.isDirectory() ? copyDir(srcPath, destPath) : fs.copyFileSync(srcPath, destPath);
+    });
+}
+exports.copyDir = copyDir;
 //# sourceMappingURL=packageUtils.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/packaging",
-  "version": "0.1.20",
+  "version": "1.0.2",
   "description": "packing libraries to Salesforce packaging platform",
   "main": "lib/exported",
   "types": "lib/exported.d.ts",
@@ -65,7 +65,7 @@
     "@types/jszip": "^3.4.1",
     "@types/xml2js": "^0.4.11",
     "@typescript-eslint/eslint-plugin": "^5.40.1",
-    "@typescript-eslint/parser": "5.41.0",
+    "@typescript-eslint/parser": "5.42.0",
     "chai": "^4.3.6",
     "commitizen": "^4.2.4",
     "eslint": "^8.26.0",

package/lib/constants.d.ts

@@ -1,26 +0,0 @@
-import { Duration } from '@salesforce/kit';
-export declare const consts: {
-    DEFAULT_USER_DIR_MODE: string;
-    DEFAULT_USER_FILE_MODE: string;
-    DEFAULT_STREAM_TIMEOUT_MINUTES: number;
-    MIN_STREAM_TIMEOUT_MINUTES: number;
-    DEFAULT_SRC_WAIT_MINUTES: number;
-    DEFAULT_MDAPI_WAIT_MINUTES: number;
-    DEFAULT_MDAPI_RETRIEVE_WAIT_MINUTES: number;
-    DEFAULT_MDAPI_POLL_INTERVAL_MINUTES: number;
-    DEFAULT_MDAPI_POLL_INTERVAL_MILLISECONDS: number;
-    MIN_SRC_WAIT_MINUTES: number;
-    MIN_SRC_DEPLOY_WAIT_MINUTES: number;
-    WORKSPACE_CONFIG_FILENAME: string;
-    OLD_WORKSPACE_CONFIG_FILENAME: string;
-    DEFAULT_DEV_HUB_USERNAME: string;
-    DEFAULT_USERNAME: string;
-    ACKNOWLEDGED_USAGE_COLLECTION_FILENAME: string;
-    PACKAGE_VERSION_INFO_FILE_ZIP: string;
-    INSTANCE_URL_TOKEN: string;
-    PACKAGE2_DESCRIPTOR_FILE: string;
-    PACKAGE_INSTALL_POLL_FREQUENCY: number;
-    PACKAGE_INSTALL_POLL_TIMEOUT: number;
-    PACKAGE_PUBLISH_POLL_FREQUENCY: Duration;
-    PACKAGE_PUBLISH_POLL_TIMEOUT: Duration;
-};

package/lib/constants.js

@@ -1,45 +0,0 @@
-"use strict";
-/*
- * Copyright (c) 2022, salesforce.com, inc.
- * All rights reserved.
- * Licensed under the BSD 3-Clause license.
- * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.consts = void 0;
-/* --------------------------------------------------------------------------------------------------------------------
- * WARNING: This file has been deprecated and should now be considered locked against further changes.  Its contents
- * have been partially or wholly superseded by functionality included in the @salesforce/core npm package, and exists
- * now to service prior uses in this repository only until they can be ported to use the new @salesforce/core library.
- *
- * If you need or want help deciding where to add new functionality or how to migrate to the new library, please
- * contact the CLI team at alm-cli@salesforce.com.
- * ----------------------------------------------------------------------------------------------------------------- */
-const kit_1 = require("@salesforce/kit");
-exports.consts = {
-    DEFAULT_USER_DIR_MODE: '700',
-    DEFAULT_USER_FILE_MODE: '600',
-    DEFAULT_STREAM_TIMEOUT_MINUTES: 6,
-    MIN_STREAM_TIMEOUT_MINUTES: 2,
-    DEFAULT_SRC_WAIT_MINUTES: 33,
-    DEFAULT_MDAPI_WAIT_MINUTES: 0,
-    DEFAULT_MDAPI_RETRIEVE_WAIT_MINUTES: -1,
-    DEFAULT_MDAPI_POLL_INTERVAL_MINUTES: 0.1,
-    DEFAULT_MDAPI_POLL_INTERVAL_MILLISECONDS: 0.1 * 60 * 1000,
-    MIN_SRC_WAIT_MINUTES: 1,
-    MIN_SRC_DEPLOY_WAIT_MINUTES: 0,
-    WORKSPACE_CONFIG_FILENAME: 'sfdx-project.json',
-    OLD_WORKSPACE_CONFIG_FILENAME: 'sfdx-workspace.json',
-    DEFAULT_DEV_HUB_USERNAME: 'defaultdevhubusername',
-    DEFAULT_USERNAME: 'defaultusername',
-    ACKNOWLEDGED_USAGE_COLLECTION_FILENAME: 'acknowledgedUsageCollection.json',
-    PACKAGE_VERSION_INFO_FILE_ZIP: 'package-version-info.zip',
-    // tokens to be replaced on source:push
-    INSTANCE_URL_TOKEN: '__SFDX_INSTANCE_URL__',
-    PACKAGE2_DESCRIPTOR_FILE: 'package2-descriptor.json',
-    PACKAGE_INSTALL_POLL_FREQUENCY: 5000,
-    PACKAGE_INSTALL_POLL_TIMEOUT: 5,
-    PACKAGE_PUBLISH_POLL_FREQUENCY: kit_1.Duration.milliseconds(0),
-    PACKAGE_PUBLISH_POLL_TIMEOUT: kit_1.Duration.milliseconds(0), // 0ms
-};
-//# sourceMappingURL=constants.js.map

package/lib/package/packageInstalledList.d.ts

@@ -1,3 +0,0 @@
-import { Connection } from '@salesforce/core';
-import { InstalledPackages } from '../interfaces';
-export declare function packageInstalledList(conn: Connection): Promise<InstalledPackages[]>;

package/lib/package/packageInstalledList.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.packageInstalledList = void 0;
-const utils_1 = require("../utils");
-async function packageInstalledList(conn) {
-    try {
-        const query = 'SELECT Id, SubscriberPackageId, SubscriberPackage.NamespacePrefix, SubscriberPackage.Name, SubscriberPackageVersion.Id, SubscriberPackageVersion.Name, SubscriberPackageVersion.MajorVersion, SubscriberPackageVersion.MinorVersion, SubscriberPackageVersion.PatchVersion, SubscriberPackageVersion.BuildNumber FROM InstalledSubscriberPackage ORDER BY SubscriberPackageId';
-        return (await conn.tooling.query(query)).records;
-    }
-    catch (err) {
-        throw (0, utils_1.applyErrorAction)((0, utils_1.massageErrorMessage)(err));
-    }
-}
-exports.packageInstalledList = packageInstalledList;
-//# sourceMappingURL=packageInstalledList.js.map

package/lib/utils/srcDevUtils.d.ts

@@ -1,11 +0,0 @@
-/**
- * Zips directory to given zipfile.
- *
- * https://github.com/archiverjs/node-archiver
- *
- * @param dir to zip
- * @param zipfile
- */
-export declare function zipDir(dir: string, zipfile: string): Promise<void>;
-export declare function getElapsedTime(timer: [number, number]): string;
-export declare function copyDir(src: string, dest: string): void;

package/lib/utils/srcDevUtils.js

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.copyDir = exports.getElapsedTime = exports.zipDir = void 0;
-/*
- * Copyright (c) 2020, salesforce.com, inc.
- * All rights reserved.
- * Licensed under the BSD 3-Clause license.
- * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-const fs = require("fs");
-const path_1 = require("path");
-const stream_1 = require("stream");
-const util_1 = require("util");
-const core_1 = require("@salesforce/core");
-const globby = require("globby");
-const JSZIP = require("jszip");
-const pipeline = (0, util_1.promisify)(stream_1.pipeline);
-/**
- * Zips directory to given zipfile.
- *
- * https://github.com/archiverjs/node-archiver
- *
- * @param dir to zip
- * @param zipfile
- */
-async function zipDir(dir, zipfile) {
-    const logger = core_1.Logger.childFromRoot('srcDevUtils#zipDir');
-    const timer = process.hrtime();
-    const globbyResult = await globby('**/*', { expandDirectories: true, cwd: dir });
-    const zip = new JSZIP();
-    // add files tp zip
-    for (const file of globbyResult) {
-        zip.file(file, fs.readFileSync((0, path_1.join)(dir, file)));
-    }
-    // write zip to file
-    const zipStream = zip.generateNodeStream({
-        type: 'nodebuffer',
-        streamFiles: true,
-        compression: 'DEFLATE',
-        compressionOptions: {
-            level: 3,
-        },
-    });
-    await pipeline(zipStream, fs.createWriteStream(zipfile));
-    const stat = fs.statSync(zipfile);
-    logger.debug(`${stat.size} bytes written to ${zipfile} in ${getElapsedTime(timer)}ms`);
-    return;
-}
-exports.zipDir = zipDir;
-function getElapsedTime(timer) {
-    const elapsed = process.hrtime(timer);
-    return (elapsed[0] * 1000 + elapsed[1] / 1000000).toFixed(3);
-}
-exports.getElapsedTime = getElapsedTime;
-function copyDir(src, dest) {
-    fs.mkdirSync(dest, { recursive: true });
-    const entries = fs.readdirSync(src, { withFileTypes: true });
-    entries.map((entry) => {
-        const srcPath = (0, path_1.join)(src, entry.name);
-        const destPath = (0, path_1.join)(dest, entry.name);
-        return entry.isDirectory() ? copyDir(srcPath, destPath) : fs.copyFileSync(srcPath, destPath);
-    });
-}
-exports.copyDir = copyDir;
-//# sourceMappingURL=srcDevUtils.js.map

package/lib/utils/uniqid.d.ts

@@ -1,14 +0,0 @@
-/**
- * A function to generate a unique id and return it in the context of a template, if supplied.
- *
- * A template is a string that can contain `${%s}` to be replaced with a unique id.
- * If the template contains the "%s" placeholder, it will be replaced with the unique id otherwise the id will be appended to the template.
- *
- * @param options an object with the following properties:
- * - template: a template string.
- * - length: the length of the unique id as presented in hexadecimal.
- */
-export declare function uniqid(options?: {
-    template?: string;
-    length?: number;
-}): string;

package/lib/utils/uniqid.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.uniqid = void 0;
-/*
- * Copyright (c) 2022, salesforce.com, inc.
- * All rights reserved.
- * Licensed under the BSD 3-Clause license.
- * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-const crypto_1 = require("crypto");
-const util = require("util");
-/**
- * A function to generate a unique id and return it in the context of a template, if supplied.
- *
- * A template is a string that can contain `${%s}` to be replaced with a unique id.
- * If the template contains the "%s" placeholder, it will be replaced with the unique id otherwise the id will be appended to the template.
- *
- * @param options an object with the following properties:
- * - template: a template string.
- * - length: the length of the unique id as presented in hexadecimal.
- */
-function uniqid(options) {
-    const uniqueString = (0, crypto_1.randomBytes)(Math.ceil((options?.length ?? 32) / 2.0))
-        .toString('hex')
-        .slice(0, options?.length ?? 32);
-    if (!options?.template) {
-        return uniqueString;
-    }
-    return options.template.includes('%s')
-        ? util.format(options.template, uniqueString)
-        : `${options.template}${uniqueString}`;
-}
-exports.uniqid = uniqid;
-//# sourceMappingURL=uniqid.js.map