@crossdelta/infrastructure 0.2.1 → 0.2.3

package/README.md

@@ -41,7 +41,6 @@ export default config
 
 ```typescript
 // infra/index.ts
-import { join } from 'node:path'
 import {
   buildServices,
   buildIngressRules,
@@ -51,7 +50,7 @@ import {
 } from '@crossdelta/infrastructure'
 import { App } from '@pulumi/digitalocean'
 
-const serviceConfigs = discoverServices(join(__dirname, 'services'))
+const serviceConfigs = discoverServices('services')
 
 const app = new App('my-app', {
   spec: {
@@ -172,7 +171,7 @@ These helpers work both locally (via `.env.local`) and in production (via DO App
 
 | Function | Description |
 |----------|-------------|
-| `discoverServices(dir)` | Auto-discover service configs from directory |
+| `discoverServices(dir)` | Auto-discover service configs (relative to cwd or absolute) |
 | `buildServices(options)` | Build App Platform service specs |
 | `buildIngressRules(configs)` | Generate ingress rules |
 | `buildServiceUrlEnvs(configs)` | Create SERVICE_NAME_URL env vars |

package/dist/helpers/discover-services.d.ts

@@ -2,6 +2,17 @@ import type { ServiceConfig } from '../types';
 /**
  * Auto-discovers all service configurations from a directory.
  * Each .ts file (except index.ts) should export a ServiceConfig as default.
+ *
+ * @param servicesDir - Path to services directory (relative to cwd or absolute)
  * @throws Error if duplicate ports are detected
+ *
+ * @example
+ * ```typescript
+ * // Relative path (resolved from process.cwd())
+ * const configs = discoverServices('infra/services')
+ *
+ * // Absolute path
+ * const configs = discoverServices('/absolute/path/to/services')
+ * ```
  */
 export declare function discoverServices(servicesDir: string): ServiceConfig[];

package/dist/helpers/generate-service-env.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generate service-specific env.ts content.
+ *
+ * @param serviceName - The name of the service (e.g., 'orders', 'api-gateway')
+ * @returns The content for the service's src/env.ts file
+ *
+ * @example
+ * ```typescript
+ * import { generateServiceEnvFile } from '@crossdelta/infrastructure'
+ * import { writeFileSync } from 'node:fs'
+ *
+ * const content = generateServiceEnvFile('orders')
+ * writeFileSync('services/orders/src/env.ts', content)
+ * ```
+ */
+export declare function generateServiceEnvFile(serviceName: string): string;

package/dist/helpers/index.d.ts

@@ -1,6 +1,7 @@
 export * from './config';
 export * from './discover-services';
 export * from './docker-hub-image';
+export * from './generate-service-env';
 export * from './image';
 export * from './service-builder';
 export * from './service-runtime';

package/dist/index.cjs

@@ -32,6 +32,7 @@ __export(exports_lib, {
   getServiceUrl: () => getServiceUrl,
   getServicePort: () => getServicePort2,
   getImage: () => getImage,
+  generateServiceEnvFile: () => generateServiceEnvFile,
   ensureDot: () => ensureDot,
   dockerHubImage: () => dockerHubImage,
   discoverServices: () => discoverServices,
@@ -105,9 +106,10 @@ ${conflicts.join(`
   }
 }
 function discoverServices(servicesDir) {
-  const files = import_node_fs.readdirSync(servicesDir).filter((file) => file.endsWith(".ts") && file !== "index.ts");
+  const resolvedDir = import_node_path.isAbsolute(servicesDir) ? servicesDir : import_node_path.resolve(process.cwd(), servicesDir);
+  const files = import_node_fs.readdirSync(resolvedDir).filter((file) => file.endsWith(".ts") && file !== "index.ts");
   const configs = files.map((file) => {
-    const module2 = require(import_node_path.join(servicesDir, file));
+    const module2 = require(import_node_path.join(resolvedDir, file));
     return module2.default;
   });
   validateNoDuplicatePorts(configs);
@@ -127,6 +129,39 @@ var dockerHubImage = (repository, tag, registry = "library") => ({
   repository,
   tag
 });
+// lib/helpers/generate-service-env.ts
+function generateServiceEnvFile(serviceName) {
+  const envKey = serviceName.toUpperCase().replace(/-/g, "_");
+  return `/**
+ * Service environment configuration.
+ * Auto-generated by: bun run generate-env
+ * DO NOT EDIT MANUALLY - changes will be overwritten!
+ */
+
+import {
+  getServicePort as _getServicePort,
+  getServiceUrl as _getServiceUrl,
+} from '@crossdelta/infrastructure/env'
+
+/** This service's name */
+export const SERVICE_NAME = '${serviceName}' as const
+export type ServiceName = typeof SERVICE_NAME
+
+/**
+ * Get the port for this service from environment variables.
+ * Reads from ${envKey}_PORT
+ */
+export const getServicePort = (defaultPort = 8080): number =>
+  _getServicePort(SERVICE_NAME, defaultPort)
+
+/**
+ * Get the URL for this service from environment variables.
+ * Reads from ${envKey}_URL
+ */
+export const getServiceUrl = (): string | undefined =>
+  _getServiceUrl(SERVICE_NAME)
+`;
+}
 // lib/helpers/image.ts
 var scopeImageTagsRaw = process.env.SCOPE_IMAGE_TAGS ?? "";
 var scopeImageTags = (() => {

package/dist/index.js

@@ -32,7 +32,7 @@ var defaultHealthCheck = {
 };
 // lib/helpers/discover-services.ts
 import { readdirSync } from "node:fs";
-import { join } from "node:path";
+import { isAbsolute, join, resolve } from "node:path";
 function getServicePort(config) {
   if (config.httpPort)
     return config.httpPort;
@@ -57,9 +57,10 @@ ${conflicts.join(`
   }
 }
 function discoverServices(servicesDir) {
-  const files = readdirSync(servicesDir).filter((file) => file.endsWith(".ts") && file !== "index.ts");
+  const resolvedDir = isAbsolute(servicesDir) ? servicesDir : resolve(process.cwd(), servicesDir);
+  const files = readdirSync(resolvedDir).filter((file) => file.endsWith(".ts") && file !== "index.ts");
   const configs = files.map((file) => {
-    const module = __require(join(servicesDir, file));
+    const module = __require(join(resolvedDir, file));
     return module.default;
   });
   validateNoDuplicatePorts(configs);
@@ -79,6 +80,39 @@ var dockerHubImage = (repository, tag, registry = "library") => ({
   repository,
   tag
 });
+// lib/helpers/generate-service-env.ts
+function generateServiceEnvFile(serviceName) {
+  const envKey = serviceName.toUpperCase().replace(/-/g, "_");
+  return `/**
+ * Service environment configuration.
+ * Auto-generated by: bun run generate-env
+ * DO NOT EDIT MANUALLY - changes will be overwritten!
+ */
+
+import {
+  getServicePort as _getServicePort,
+  getServiceUrl as _getServiceUrl,
+} from '@crossdelta/infrastructure/env'
+
+/** This service's name */
+export const SERVICE_NAME = '${serviceName}' as const
+export type ServiceName = typeof SERVICE_NAME
+
+/**
+ * Get the port for this service from environment variables.
+ * Reads from ${envKey}_PORT
+ */
+export const getServicePort = (defaultPort = 8080): number =>
+  _getServicePort(SERVICE_NAME, defaultPort)
+
+/**
+ * Get the URL for this service from environment variables.
+ * Reads from ${envKey}_URL
+ */
+export const getServiceUrl = (): string | undefined =>
+  _getServiceUrl(SERVICE_NAME)
+`;
+}
 // lib/helpers/image.ts
 var scopeImageTagsRaw = process.env.SCOPE_IMAGE_TAGS ?? "";
 var scopeImageTags = (() => {
@@ -214,6 +248,7 @@ export {
   getServiceUrl,
   getServicePort2 as getServicePort,
   getImage,
+  generateServiceEnvFile,
   ensureDot,
   dockerHubImage,
   discoverServices,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/infrastructure",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "license": "MIT",
   "publishConfig": {