@hasna/connectors 1.3.32 → 1.3.33

package/dist/lib/connector-resolver.d.ts

@@ -0,0 +1,37 @@
+export declare const LEGACY_CONNECTOR_PREFIX = "connect-";
+export interface ConnectorNameResolution {
+    input: string;
+    canonicalName: string;
+    legacyName: string;
+    aliases: string[];
+    isLegacyInput: boolean;
+}
+export interface ConnectorPackagePathResolution extends ConnectorNameResolution {
+    connectorsDir: string;
+    preferredDirName: string;
+    preferredPath: string;
+    existingPath: string | null;
+    existingDirName: string | null;
+    checkedPaths: string[];
+}
+export interface ConnectorConfigPathResolution extends ConnectorNameResolution {
+    connectorsHome: string;
+    preferredDirName: string;
+    preferredPath: string;
+    legacyPath: string;
+    existingPaths: string[];
+    readPaths: string[];
+}
+export declare function normalizeConnectorName(name: string): string;
+export declare function legacyConnectorName(name: string): string;
+export declare function resolveConnectorName(name: string): ConnectorNameResolution;
+export declare function isValidConnectorName(name: string): boolean;
+export declare function connectorPackageDirNames(name: string): string[];
+export declare function connectorConfigDirNames(name: string): string[];
+export declare function resolveConnectorPackagePath(connectorsDir: string, name: string): ConnectorPackagePathResolution;
+export declare function getConnectorPackagePath(connectorsDir: string, name: string): string;
+export declare function resolveConnectorConfigPaths(name: string, connectorsHome?: string): ConnectorConfigPathResolution;
+export declare function getConnectorConfigDir(name: string, connectorsHome?: string): string;
+export declare function getExistingConnectorConfigDirs(name: string, connectorsHome?: string): string[];
+export declare function getConnectorConfigReadDirs(name: string, connectorsHome?: string): string[];
+export declare function listConfiguredConnectorNames(connectorsHome?: string): string[];

package/dist/lib/connector-resolver.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lock.d.ts

@@ -7,7 +7,7 @@
  *
  * Strategy: atomic O_EXCL file creation as the lock primitive (works on all
  * platforms including macOS). Lock files live at:
- *   ~/.hasna/connectors/connect-{name}/.write.lock
+ *   ~/.hasna/connectors/{name}/.write.lock
  *
  * Callers that cannot acquire the lock within the timeout receive a LockTimeoutError.
  */

package/dist/lib/manifest.d.ts

@@ -0,0 +1,50 @@
+import { type Category, type ConnectorMeta } from "./registry.js";
+import { type ConnectorDocs } from "./installer.js";
+import { type ConnectorOperationDescriptor } from "./runner.js";
+import { type AuthType } from "../server/auth.js";
+export interface ConnectorCapabilityRuntime {
+    packageName: "@hasna/connectors";
+    connectorId: string;
+    legacyConnectorId: string;
+    packagePath: string;
+    configDirName: string;
+    legacyConfigDirName: string;
+    internal: boolean;
+    packageDirectory: boolean;
+    commandSurface: boolean;
+}
+export interface ConnectorCapabilityAuth {
+    type: AuthType;
+    summary: string | null;
+    envVars: ConnectorDocs["envVars"];
+}
+export interface ConnectorCapabilityDocs {
+    overview: string;
+    cliCommands: string;
+    dataStorage: string | null;
+}
+export interface ConnectorCapability extends ConnectorMeta {
+    id: string;
+    aliases: string[];
+    runtime: ConnectorCapabilityRuntime;
+    auth: ConnectorCapabilityAuth;
+    docs: ConnectorCapabilityDocs;
+    operations?: ConnectorOperationDescriptor[];
+}
+export interface ConnectorCapabilityManifest {
+    version: 1;
+    packageName: "@hasna/connectors";
+    packageVersion: string;
+    generatedAt: string;
+    categories: readonly Category[];
+    connectorCount: number;
+    connectors: ConnectorCapability[];
+}
+export interface ConnectorCapabilityOptions {
+    includeOperations?: boolean;
+}
+export interface ConnectorCapabilityManifestOptions extends ConnectorCapabilityOptions {
+    connectorNames?: string[];
+}
+export declare function getConnectorCapability(name: string, options?: ConnectorCapabilityOptions): Promise<ConnectorCapability | null>;
+export declare function getConnectorCapabilityManifest(options?: ConnectorCapabilityManifestOptions): Promise<ConnectorCapabilityManifest>;

package/dist/lib/manifest.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/runner-auth.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/runner.d.ts

@@ -44,6 +44,28 @@ export interface RunResult {
     exitCode: number;
     success: boolean;
 }
+export interface RunConnectorOperationArgs {
+    connector: string;
+    operation: string;
+    input?: Record<string, unknown> & {
+        /**
+         * Positional arguments for legacy connector command surfaces.
+         *
+         * Example: { args: ["MESSAGE_ID"], body: true } becomes
+         * `messages read MESSAGE_ID --body --format json`.
+         */
+        args?: Array<string | number | boolean>;
+    };
+    profile?: string;
+    timeoutMs?: number;
+    parseJson?: boolean;
+}
+export interface ConnectorOperationResult<T = unknown> extends RunResult {
+    connector: string;
+    operation: string;
+    profile?: string;
+    data?: T;
+}
 /**
  * Run a connector CLI command as a subprocess.
  *
@@ -52,6 +74,15 @@ export interface RunResult {
  * @param timeoutMs - Max execution time (default 30s)
  */
 export declare function runConnectorCommand(name: string, args: string[], timeoutMs?: number): Promise<RunResult>;
+/**
+ * Run a connector operation through the one-product runtime.
+ *
+ * This is the stable SDK surface for consumers such as @hasna/files. It avoids
+ * importing individual connect-* packages while still supporting legacy
+ * connector CLIs during the migration to internal connector definitions.
+ */
+export declare function runConnectorOperation<T = unknown>(args: RunConnectorOperationArgs): Promise<ConnectorOperationResult<T>>;
+export declare function buildConnectorOperationArgs(args: RunConnectorOperationArgs): string[];
 /**
  * Get the list of available operations for a connector by parsing its --help output.
  * Returns structured command list.

package/dist/lib/test-endpoints.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/workflow-runner.d.ts

@@ -4,7 +4,13 @@
  * Each step receives the previous step's output as additional context
  * injected into its args as --input <previous_output>.
  */
+import { spawn as nodeSpawn } from "child_process";
 import type { ConnectorWorkflow } from "../db/workflows.js";
+type SpawnFn = typeof nodeSpawn;
+/** @internal Test hook for substituting process spawning. */
+export declare function __setSpawnForTests(fn: SpawnFn): void;
+/** @internal Restore default process spawning after tests. */
+export declare function __resetSpawnForTests(): void;
 export interface WorkflowStepResult {
     step: number;
     connector: string;
@@ -20,3 +26,4 @@ export interface WorkflowResult {
     final_output: string;
 }
 export declare function runWorkflow(workflow: ConnectorWorkflow): Promise<WorkflowResult>;
+export {};

package/dist/mcp/http.d.ts

@@ -0,0 +1,14 @@
+export declare const MCP_HTTP_PORT = 8854;
+export declare const MCP_NAME = "connectors";
+export declare function isHttpMode(argv: string[]): boolean;
+export declare function isStdioMode(argv: string[]): boolean;
+export declare function resolveHttpPort(argv: string[]): number;
+export declare function healthPayload(): {
+    status: string;
+    name: string;
+};
+export declare function handleMcpHttpRequest(req: Request): Promise<Response | null>;
+export declare function startMcpHttpServer(port: number): Promise<{
+    port: number;
+    stop: () => void;
+}>;

package/dist/mcp/http.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mcp/index.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env bun
-export {};
+export { buildServer } from "./server.js";

package/dist/mcp/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function buildServer(): McpServer;

package/dist/server/auth-exchange.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server/auth-refresh.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server/auth.d.ts

@@ -9,6 +9,7 @@ export interface AuthStatus {
     configured: boolean;
     tokenExpiry?: number;
     hasRefreshToken?: boolean;
+    hasOAuthCredentials?: boolean;
     envVars: {
         variable: string;
         description: string;
@@ -78,18 +79,18 @@ export declare function refreshOAuthToken(name: string): Promise<OAuthTokens>;
 export declare function getTokenExpiry(name: string): number | null;
 /**
  * List all profile names for a connector.
- * Reads ~/.hasna/connectors/connect-{name}/profiles/ directory entries —
+ * Reads ~/.hasna/connectors/{name}/profiles/ and legacy connect-{name} entries —
  * both .json files (pattern 1) and subdirectories (pattern 2).
  */
 export declare function listProfiles(name: string): string[];
 /**
  * Switch the active profile for a connector.
- * Writes the profile name to ~/.hasna/connectors/connect-{name}/current_profile
+ * Writes the profile name to ~/.hasna/connectors/{name}/current_profile
  */
 export declare function switchProfile(name: string, profile: string): void;
 /**
  * Delete a profile for a connector.
- * Removes the profile file or directory from ~/.hasna/connectors/connect-{name}/profiles/.
+ * Removes the profile file or directory from ~/.hasna/connectors/{name}/profiles/.
  * Refuses to delete the "default" profile.
  * Returns true if deletion succeeded, false if profile not found or is "default".
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "1.3.32",
+  "version": "1.3.33",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {