@docker-harpoon/core 0.1.0 → 0.1.3

package/dist/resources/schemas.js

@@ -0,0 +1,95 @@
+/**
+ * Zod Schemas for Container Resources
+ *
+ * Defines validation schemas for container stats, exec, and log streaming.
+ * Following Alchemy.run patterns for declarative resource definitions.
+ */
+import { z } from 'zod';
+// ============ Container Stats Schema ============
+/**
+ * CPU statistics from Docker container
+ */
+export const cpuStatsSchema = z.object({
+    usage: z.number().min(0).describe('CPU usage in nanoseconds'),
+    system: z.number().min(0).describe('System CPU usage in nanoseconds'),
+    percent: z.number().min(0).max(100).describe('CPU usage as percentage'),
+    cores: z.number().int().min(0).describe('Number of CPU cores available'),
+});
+/**
+ * Memory statistics from Docker container
+ */
+export const memoryStatsSchema = z.object({
+    usage: z.number().min(0).describe('Current memory usage in bytes'),
+    limit: z.number().min(0).describe('Memory limit in bytes'),
+    percent: z.number().min(0).max(100).describe('Memory usage as percentage'),
+    usageMB: z.number().min(0).describe('Current memory usage in megabytes'),
+    limitMB: z.number().min(0).describe('Memory limit in megabytes'),
+});
+/**
+ * Network I/O statistics from Docker container
+ */
+export const networkStatsSchema = z.object({
+    rxBytes: z.number().min(0).describe('Bytes received'),
+    txBytes: z.number().min(0).describe('Bytes transmitted'),
+    rxPackets: z.number().min(0).describe('Packets received'),
+    txPackets: z.number().min(0).describe('Packets transmitted'),
+});
+/**
+ * Complete container statistics
+ */
+export const containerStatsSchema = z.object({
+    cpu: cpuStatsSchema,
+    memory: memoryStatsSchema,
+    network: networkStatsSchema,
+    timestamp: z.string().datetime().describe('ISO 8601 timestamp of stats collection'),
+    containerId: z.string().describe('Docker container ID'),
+});
+// ============ Exec Schemas ============
+/**
+ * Options for executing a command in a container
+ */
+export const execOptionsSchema = z.object({
+    cmd: z.array(z.string()).min(1).describe('Command and arguments to execute'),
+    env: z.record(z.string(), z.string()).optional().describe('Environment variables'),
+    workingDir: z.string().optional().describe('Working directory for the command'),
+    user: z.string().optional().describe('User to run the command as'),
+    privileged: z.boolean().optional().describe('Run with elevated privileges'),
+    tty: z.boolean().optional().describe('Allocate a pseudo-TTY'),
+});
+/**
+ * Result of executing a command in a container
+ */
+export const execResultSchema = z.object({
+    exitCode: z.number().int().describe('Exit code of the command'),
+    stdout: z.string().describe('Standard output'),
+    stderr: z.string().describe('Standard error'),
+    durationMs: z.number().min(0).describe('Execution duration in milliseconds'),
+});
+// ============ Log Streaming Schemas ============
+/**
+ * Options for streaming container logs
+ */
+export const logOptionsSchema = z.object({
+    stdout: z.boolean().optional().describe('Include stdout (default: true)'),
+    stderr: z.boolean().optional().describe('Include stderr (default: true)'),
+    since: z.number().optional().describe('Unix timestamp to start from'),
+    until: z.number().optional().describe('Unix timestamp to end at'),
+    tail: z.number().int().min(0).optional().describe('Number of lines to tail'),
+    timestamps: z.boolean().optional().describe('Include timestamps (default: false)'),
+});
+/**
+ * A single log line from a container
+ */
+export const logLineSchema = z.object({
+    stream: z.enum(['stdout', 'stderr']).describe('Which stream this line came from'),
+    timestamp: z.string().datetime().optional().describe('Timestamp if enabled'),
+    message: z.string().describe('Log message content'),
+});
+// ============ Stats Options Schema ============
+/**
+ * Options for getting container stats
+ */
+export const statsOptionsSchema = z.object({
+    stream: z.boolean().optional().default(false).describe('Stream continuous stats'),
+    oneShot: z.boolean().optional().default(true).describe('Get single stats snapshot'),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docker-harpoon/core",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "license": "MIT",
   "description": "Core Docker resource primitives and binding interface",
   "type": "module",
@@ -12,10 +12,13 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
-    "build": "tsc",
-    "typecheck": "tsc --noEmit"
+    "build": "tsgo",
+    "typecheck": "tsgo --noEmit",
+    "test": "bun test"
   },
   "dependencies": {
     "dockerode": "^4.0.9",