@zero-transfer/core 0.4.0 → 0.4.6

package/README.md

@@ -8,6 +8,8 @@
 npm install @zero-transfer/core
 ```
 
+This is the shared foundation used by every other `@zero-transfer/*` package. You usually do **not** install it directly - pick a protocol package (e.g. [`@zero-transfer/ftp`](https://www.npmjs.com/package/@zero-transfer/ftp)) or the umbrella [`@zero-transfer/sdk`](https://www.npmjs.com/package/@zero-transfer/sdk), and core comes along automatically.
+
 ## Overview
 
 The provider-neutral foundation: `TransferClient`, `createTransferClient`, the provider registry, capability sets, transfer engine, queue, planning primitives, profile resolution, secret redaction, structured logging, and typed errors. Every other scoped package builds on this surface.
@@ -20,7 +22,7 @@ import { createLocalProviderFactory } from "@zero-transfer/core";
 
 ## Public surface
 
-This package publishes a narrowed surface of **92** exports. These symbols are also available from [`@zero-transfer/sdk`](https://www.npmjs.com/package/@zero-transfer/sdk); the table below links into the full API reference:
+This package publishes a narrowed surface of **93** exports. These symbols are also available from [`@zero-transfer/sdk`](https://www.npmjs.com/package/@zero-transfer/sdk); the table below links into the full API reference:
 
 | Symbol                                                                                                                                                         | Kind         | Notes              |
 | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------------ |
@@ -30,7 +32,7 @@ This package publishes a narrowed surface of **92** exports. These symbols are a
 | [`ProviderRegistry`](https://github.com/tonywied17/zero-transfer/blob/main/docs/api-md/classes/ProviderRegistry.md)                                            | Class        | See API reference. |
 | [`TransferSession`](https://github.com/tonywied17/zero-transfer/blob/main/docs/api-md/interfaces/TransferSession.md)                                           | Interface    | See API reference. |
 | [`TransferProvider`](https://github.com/tonywied17/zero-transfer/blob/main/docs/api-md/interfaces/TransferProvider.md)                                         | Interface    | See API reference. |
-| `ProviderCapabilities`                                                                                                                                         | _unresolved_ | —                  |
+| `ProviderCapabilities`                                                                                                                                         | _unresolved_ | -                  |
 | [`ProviderFactory`](https://github.com/tonywied17/zero-transfer/blob/main/docs/api-md/interfaces/ProviderFactory.md)                                           | Interface    | See API reference. |
 | [`ProviderTransferOperations`](https://github.com/tonywied17/zero-transfer/blob/main/docs/api-md/interfaces/ProviderTransferOperations.md)                     | Interface    | See API reference. |
 | [`RemoteFileSystem`](https://github.com/tonywied17/zero-transfer/blob/main/docs/api-md/interfaces/RemoteFileSystem.md)                                         | Interface    | See API reference. |
@@ -116,6 +118,7 @@ This package publishes a narrowed surface of **92** exports. These symbols are a
 | [`ZeroTransferLogger`](https://github.com/tonywied17/zero-transfer/blob/main/docs/api-md/interfaces/ZeroTransferLogger.md)                                     | Interface    | See API reference. |
 | [`noopLogger`](https://github.com/tonywied17/zero-transfer/blob/main/docs/api-md/variables/noopLogger.md)                                                      | Variable     | See API reference. |
 | [`emitLog`](https://github.com/tonywied17/zero-transfer/blob/main/docs/api-md/functions/emitLog.md)                                                            | Function     | See API reference. |
+| [`isMainModule`](https://github.com/tonywied17/zero-transfer/blob/main/docs/api-md/functions/isMainModule.md)                                                  | Function     | See API reference. |
 
 ## Examples
 

package/dist/index.cjs

@@ -82,6 +82,7 @@ __export(core_exports, {
   importOpenSshConfig: () => importOpenSshConfig,
   importWinScpSessions: () => importWinScpSessions,
   isClassicProviderId: () => isClassicProviderId,
+  isMainModule: () => isMainModule,
   isSensitiveKey: () => isSensitiveKey,
   joinRemotePath: () => joinRemotePath,
   matchKnownHosts: () => matchKnownHosts,
@@ -4889,6 +4890,19 @@ function isModifiedAtDifferent2(source, destination, toleranceMs) {
   if (Number.isNaN(sourceTime) || Number.isNaN(destinationTime)) return false;
   return Math.abs(sourceTime - destinationTime) > toleranceMs;
 }
+
+// src/utils/mainModule.ts
+var import_node_url = require("url");
+function isMainModule(importMetaUrl) {
+  if (typeof process === "undefined" || !process.argv || process.argv.length < 2) {
+    return false;
+  }
+  try {
+    return process.argv[1] === (0, import_node_url.fileURLToPath)(importMetaUrl);
+  } catch {
+    return false;
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AbortError,
@@ -4943,6 +4957,7 @@ function isModifiedAtDifferent2(source, destination, toleranceMs) {
   importOpenSshConfig,
   importWinScpSessions,
   isClassicProviderId,
+  isMainModule,
   isSensitiveKey,
   joinRemotePath,
   matchKnownHosts,