@crossdelta/infrastructure 0.2.11 → 0.2.13

package/dist/types/index.d.ts

@@ -24,6 +24,50 @@ export interface ImageConfig {
     /** Image tag (e.g., '2.10-alpine', 'latest') */
     tag: string;
 }
+/**
+ * Platform type for service deployment.
+ */
+export declare const Platform: {
+    /** DigitalOcean App Platform (default) */
+    readonly APP_PLATFORM: "app-platform";
+    /** DigitalOcean Droplet with Docker */
+    readonly DROPLET: "droplet";
+};
+export type Platform = (typeof Platform)[keyof typeof Platform];
+/**
+ * Volume configuration for persistent storage (Droplet only).
+ */
+export interface VolumeConfig {
+    /** Volume name (must be unique) */
+    name: string;
+    /** Mount path inside the container */
+    mountPath: string;
+    /** Size in GB */
+    sizeGb: number;
+}
+/**
+ * Droplet-specific configuration options.
+ */
+export interface DropletConfig {
+    /** Droplet size slug (e.g., 's-1vcpu-1gb') */
+    size: string;
+    /** Persistent volumes to attach */
+    volumes?: VolumeConfig[];
+    /** Firewall rules for VPC access */
+    vpcPorts?: number[];
+    /** Additional Docker run arguments */
+    dockerArgs?: string;
+    /**
+     * Config file to mount into the container.
+     * The content will be written to the Droplet and mounted into Docker.
+     */
+    configFile?: {
+        /** Path inside the container (e.g., '/etc/nats/nats.conf') */
+        containerPath: string;
+        /** File content (will be written to Droplet) */
+        content: string;
+    };
+}
 /**
  * Configuration for a service that will be deployed to DigitalOcean App Platform.
  * Each service in infra/services/*.ts should export a default object of this type.
@@ -39,17 +83,30 @@ export interface ImageConfig {
  * - `<SERVICE>_PORT` environment variable
  * - `<SERVICE>_URL` environment variable (unless `internalUrl` is set)
  *
+ * ## Platform Selection
+ *
+ * By default, services run on App Platform. Set `platform: 'droplet'` for services
+ * that need persistent storage or special networking (e.g., NATS with JetStream).
+ *
  * ## Examples
  *
  * ```ts
- * // Public service (API Gateway)
+ * // Public service on App Platform (API Gateway)
  * { httpPort: 4000, ingressPrefix: '/api' }
  *
- * // Internal-only service (Orders)
+ * // Internal-only service on App Platform (Orders)
  * { internalPorts: [4001] }
  *
- * // Internal service with custom protocol (NATS)
- * { internalPorts: [4222, 8222], internalUrl: 'nats://nats:4222' }
+ * // Service on Droplet with persistent volume (NATS)
+ * {
+ *   platform: 'droplet',
+ *   internalPorts: [4222, 8222],
+ *   internalUrl: 'nats://nats:4222',
+ *   droplet: {
+ *     size: 's-1vcpu-1gb',
+ *     volumes: [{ name: 'nats-data', mountPath: '/data', sizeGb: 10 }],
+ *   },
+ * }
  * ```
  *
  * @see https://docs.digitalocean.com/reference/api/digitalocean/#tag/Apps
@@ -57,6 +114,11 @@ export interface ImageConfig {
 export type ServiceConfig = Partial<Omit<AppSpecService, 'image'>> & {
     /** Unique name of the service (required) */
     name: string;
+    /**
+     * Deployment platform. Defaults to 'app-platform'.
+     * Use 'droplet' for services that need persistent storage or special networking.
+     */
+    platform?: Platform;
     /**
      * Ingress path prefix for public routing (e.g., '/api').
      * Only used when `httpPort` is set. Services with only `internalPorts` cannot have ingress.
@@ -72,6 +134,10 @@ export type ServiceConfig = Partial<Omit<AppSpecService, 'image'>> & {
      * If not set, defaults to `http://{name}:{primaryPort}`.
      */
     internalUrl?: string;
+    /**
+     * Droplet-specific configuration. Only used when `platform: 'droplet'`.
+     */
+    droplet?: DropletConfig;
 };
 /**
  * Full service spec after merging with common config.

package/package.json

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