@plosson/agentio 0.3.0 → 0.3.2

package/src/utils/client-factory.ts

@@ -0,0 +1,53 @@
+import { getCredentials } from '../auth/token-store';
+import { getProfile } from '../config/config-manager';
+import { CliError } from './errors';
+import type { ServiceName } from '../types/config';
+
+export interface ClientFactoryConfig<TCredentials, TClient> {
+  service: ServiceName;
+  createClient: (credentials: TCredentials) => TClient;
+}
+
+/**
+ * Creates a type-safe client getter function for a service.
+ *
+ * Usage:
+ * ```typescript
+ * const getSlackClient = createClientGetter<SlackCredentials, SlackClient>({
+ *   service: 'slack',
+ *   createClient: (credentials) => new SlackClient(credentials),
+ * });
+ * ```
+ */
+export function createClientGetter<TCredentials, TClient>(
+  config: ClientFactoryConfig<TCredentials, TClient>
+): (profileName: string) => Promise<{ client: TClient; profile: string }> {
+  const { service, createClient } = config;
+
+  return async (profileName: string): Promise<{ client: TClient; profile: string }> => {
+    const profile = await getProfile(service, profileName);
+
+    if (!profile) {
+      throw new CliError(
+        'PROFILE_NOT_FOUND',
+        `Profile "${profileName}" not found for ${service}`,
+        `Run: agentio ${service} profile add`
+      );
+    }
+
+    const credentials = await getCredentials<TCredentials>(service, profile);
+
+    if (!credentials) {
+      throw new CliError(
+        'AUTH_FAILED',
+        `No credentials found for ${service} profile "${profile}"`,
+        `Run: agentio ${service} profile add --profile ${profile}`
+      );
+    }
+
+    return {
+      client: createClient(credentials),
+      profile,
+    };
+  };
+}

package/src/utils/errors.ts

@@ -10,6 +10,18 @@ export type ErrorCode =
   | 'NOT_FOUND'
   | 'CONFIG_ERROR';
 
+/**
+ * Map HTTP status codes to standard error codes.
+ * Use this in API clients to standardize error handling.
+ */
+export function httpStatusToErrorCode(status: number): ErrorCode {
+  if (status === 401) return 'AUTH_FAILED';
+  if (status === 403) return 'PERMISSION_DENIED';
+  if (status === 404) return 'NOT_FOUND';
+  if (status === 429) return 'RATE_LIMITED';
+  return 'API_ERROR';
+}
+
 export class CliError extends Error {
   constructor(
     public code: ErrorCode,

package/src/utils/obscure.ts

@@ -1,5 +1,18 @@
 import { createCipheriv, createDecipheriv, randomBytes } from 'crypto';
 
+/**
+ * Simple obfuscation utilities for embedding secrets in source code.
+ *
+ * NOT for real security - just prevents secret scanners from flagging embedded
+ * OAuth client secrets. Uses the same pattern as rclone.
+ *
+ * obscure() is exported for generating new obscured values (run in a scratch file):
+ *   import { obscure } from './src/utils/obscure';
+ *   console.log(obscure('your-secret-here'));
+ *
+ * reveal() is used at runtime to decode the obscured values.
+ */
+
 // Hardcoded key for obfuscation (not real security, just to avoid secret scanners)
 // This is the same pattern rclone uses
 const OBSCURE_KEY = Buffer.from('9c935b2aa628f0e9d48d5f3e8a4b7c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b', 'hex');