@ninedeploy/schemas 0.2.0

package/dist/kernel.js

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+// ─── Configuration Center Schemas ───────────────────────────────────────────
+export const configItemSchema = z.object({
+    key: z.string(),
+    pluginId: z.string().nullable().optional(),
+    type: z.enum(['string', 'number', 'boolean', 'enum', 'json']).default('string'),
+    isSecret: z.boolean(),
+    label: z.string(),
+    category: z.string(),
+    description: z.string().optional(),
+    tags: z.array(z.string()),
+    options: z.array(z.string()).optional(),
+    value: z.unknown(),
+    isConfigured: z.boolean(),
+    updatedAt: z.string().optional(),
+});
+export const configListSchema = z.object({
+    entries: z.array(configItemSchema),
+});
+export const setConfigSchema = z.object({
+    value: z.unknown(),
+    isSecret: z.boolean().optional(),
+    description: z.string().max(500).optional(),
+    tags: z.array(z.string().max(50)).optional(),
+});
+// ─── Plugin Ecosystem Schemas ───────────────────────────────────────────────
+export const pluginItemSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    version: z.string(),
+    description: z.string().optional(),
+    author: z.string().optional(),
+    icon: z.string().optional(),
+    isOfficial: z.boolean(),
+    enabled: z.boolean(),
+    status: z.enum(['active', 'disabled', 'errored', 'installing']),
+    configSchema: z.array(z.record(z.string(), z.unknown())).optional(),
+    menuItems: z.array(z.record(z.string(), z.unknown())).optional(),
+    dependencies: z.array(z.string()).optional(),
+    error: z.string().optional(),
+    installedAt: z.string().optional(),
+});
+export const pluginListSchema = z.object({
+    plugins: z.array(pluginItemSchema),
+});
+export const installPluginSchema = z.object({
+    source: z.enum(['marketplace', 'npm', 'git', 'local']).default('marketplace'),
+    target: z.string().min(1),
+    name: z.string().optional(),
+    version: z.string().optional(),
+    description: z.string().optional(),
+    author: z.string().optional(),
+    icon: z.string().optional(),
+    dependencies: z.array(z.string()).optional(),
+    configSchema: z.array(z.record(z.string(), z.unknown())).optional(),
+    menuItems: z.array(z.record(z.string(), z.unknown())).optional(),
+});
+export const marketplacePluginItemSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    version: z.string(),
+    description: z.string(),
+    author: z.string(),
+    icon: z.string().optional(),
+    category: z.string(),
+    isOfficial: z.boolean(),
+    isInstalled: z.boolean().default(false),
+    dependencies: z.array(z.string()).optional(),
+    configSchema: z.array(z.record(z.string(), z.unknown())).optional(),
+    menuItems: z.array(z.record(z.string(), z.unknown())).optional(),
+});
+export const marketplaceCatalogSchema = z.object({
+    catalog: z.array(marketplacePluginItemSchema),
+});
+// ─── Menu & Navigation Schemas ──────────────────────────────────────────────
+export const menuItemSchema = z.object({
+    id: z.string(),
+    pluginId: z.string().optional(),
+    slot: z.string(),
+    label: z.string(),
+    route: z.string(),
+    icon: z.string().optional(),
+    order: z.number().optional(),
+    permission: z.enum(['admin', 'member']).optional(),
+});
+export const menuListSchema = z.object({
+    slots: z.record(z.string(), z.array(menuItemSchema)),
+    items: z.array(menuItemSchema),
+});
+export const pluginInspectSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    version: z.string(),
+    description: z.string().optional(),
+    author: z.string().optional(),
+    isOfficial: z.boolean(),
+    enabled: z.boolean(),
+    status: z.enum(['active', 'disabled', 'errored', 'installing']),
+    dependencies: z.array(z.string()),
+    hooks: z.array(z.string()),
+    services: z.array(z.string()),
+    menus: z.array(menuItemSchema),
+    configSchema: z.array(z.record(z.string(), z.unknown())),
+    error: z.string().nullable().optional(),
+    installedAt: z.string().optional(),
+    runtimeStats: z.object({
+        eventsHandled: z.number(),
+        uptimeSeconds: z.number(),
+        loadedAt: z.string().optional(),
+    }),
+});
+//# sourceMappingURL=kernel.js.map

package/dist/kernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.js","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC/E,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;IACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;CACnC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC3C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAGH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IAC/D,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;CACnC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAC7E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CACjE,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACvC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CACjE,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC;CAC9C,CAAC,CAAC;AAGH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACpD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;CAC/B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IAC/D,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IAC9B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAChC,CAAC;CACH,CAAC,CAAC"}

package/dist/management.d.ts

@@ -0,0 +1,371 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for management/admin endpoints that previously used ad-hoc
+ * `as { ... }` casts. Centralising them gives consistent 400 validation errors.
+ */
+export declare const rolePatch: z.ZodObject<{
+    role: z.ZodEnum<{
+        admin: "admin";
+        member: "member";
+    }>;
+}, z.core.$strip>;
+export type RolePatch = z.infer<typeof rolePatch>;
+export declare const updateCheckResult: z.ZodObject<{
+    current: z.ZodString;
+    latest: z.ZodNullable<z.ZodString>;
+    updateAvailable: z.ZodNullable<z.ZodBoolean>;
+    notesUrl: z.ZodNullable<z.ZodString>;
+    checkedAt: z.ZodString;
+}, z.core.$strip>;
+export type UpdateCheckResult = z.infer<typeof updateCheckResult>;
+export declare const webhookCreate: z.ZodObject<{
+    branch: z.ZodOptional<z.ZodString>;
+    watchPaths: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type WebhookCreate = z.infer<typeof webhookCreate>;
+export declare const sourcePatch: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    token: z.ZodOptional<z.ZodString>;
+    deployKey: z.ZodOptional<z.ZodString>;
+    registryUsername: z.ZodOptional<z.ZodString>;
+    defaultBranch: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SourcePatch = z.infer<typeof sourcePatch>;
+export declare const notificationType: z.ZodEnum<{
+    discord: "discord";
+    email: "email";
+    ntfy: "ntfy";
+    slack: "slack";
+    telegram: "telegram";
+    webhook: "webhook";
+}>;
+export declare const notificationChannelCreate: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        discord: "discord";
+        email: "email";
+        ntfy: "ntfy";
+        slack: "slack";
+        telegram: "telegram";
+        webhook: "webhook";
+    }>;
+    target: z.ZodString;
+    eventFilter: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type NotificationChannelCreate = z.infer<typeof notificationChannelCreate>;
+export declare const notificationChannelPatch: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    target: z.ZodOptional<z.ZodString>;
+    eventFilter: z.ZodOptional<z.ZodString>;
+    active: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type NotificationChannelPatch = z.infer<typeof notificationChannelPatch>;
+export declare const alertMetricEnum: z.ZodEnum<{
+    "cert-expiry": "cert-expiry";
+    cpu: "cpu";
+    memory: "memory";
+}>;
+export declare const alertOperatorEnum: z.ZodEnum<{
+    "<": "<";
+    ">": ">";
+}>;
+export declare const alertRuleCreate: z.ZodObject<{
+    name: z.ZodString;
+    serviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    metric: z.ZodEnum<{
+        "cert-expiry": "cert-expiry";
+        cpu: "cpu";
+        memory: "memory";
+    }>;
+    operator: z.ZodDefault<z.ZodEnum<{
+        "<": "<";
+        ">": ">";
+    }>>;
+    threshold: z.ZodNumber;
+    durationWindows: z.ZodDefault<z.ZodNumber>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AlertRuleCreate = z.infer<typeof alertRuleCreate>;
+export declare const alertRulePatch: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    serviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    metric: z.ZodOptional<z.ZodEnum<{
+        "cert-expiry": "cert-expiry";
+        cpu: "cpu";
+        memory: "memory";
+    }>>;
+    operator: z.ZodOptional<z.ZodEnum<{
+        "<": "<";
+        ">": ">";
+    }>>;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    durationWindows: z.ZodOptional<z.ZodNumber>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AlertRulePatch = z.infer<typeof alertRulePatch>;
+/**
+ * Blank region/prefix fall back to the documented defaults (pre-schema
+ * behaviour); the endpoint must be an http(s) URL.
+ */
+export declare const backupDestinationCreate: z.ZodObject<{
+    name: z.ZodString;
+    endpoint: z.ZodString;
+    region: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string | undefined>>;
+    bucket: z.ZodString;
+    prefix: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string | undefined>>;
+    accessKeyId: z.ZodString;
+    secretAccessKey: z.ZodString;
+}, z.core.$strip>;
+export type BackupDestinationCreate = z.infer<typeof backupDestinationCreate>;
+/**
+ * All fields optional; blank strings are accepted here and skipped by the
+ * route (patching e.g. `name: " "` is a no-op, not an error).
+ */
+export declare const backupDestinationPatch: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    bucket: z.ZodOptional<z.ZodString>;
+    prefix: z.ZodOptional<z.ZodString>;
+    accessKeyId: z.ZodOptional<z.ZodString>;
+    secretAccessKey: z.ZodOptional<z.ZodString>;
+    active: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type BackupDestinationPatch = z.infer<typeof backupDestinationPatch>;
+/**
+ * `host` is a bare hostname (or IP) or host:port. A non-numeric port falls
+ * back to the default 4600 (pre-schema behaviour); an out-of-range one is
+ * rejected.
+ */
+export declare const serverCreate: z.ZodObject<{
+    name: z.ZodString;
+    host: z.ZodString;
+    port: z.ZodPipe<z.ZodPipe<z.ZodOptional<z.ZodUnknown>, z.ZodTransform<number, unknown>>, z.ZodNumber>;
+}, z.core.$strip>;
+export type ServerCreate = z.infer<typeof serverCreate>;
+export declare const serverAnnounce: z.ZodObject<{
+    name: z.ZodString;
+    host: z.ZodOptional<z.ZodString>;
+    port: z.ZodPipe<z.ZodPipe<z.ZodOptional<z.ZodUnknown>, z.ZodTransform<number, unknown>>, z.ZodNumber>;
+    token: z.ZodString;
+}, z.core.$strip>;
+export type ServerAnnounce = z.infer<typeof serverAnnounce>;
+export declare const sshAuthType: z.ZodEnum<{
+    key: "key";
+    password: "password";
+}>;
+export type SshAuthType = z.infer<typeof sshAuthType>;
+export declare const serverSshTest: z.ZodObject<{
+    host: z.ZodString;
+    sshPort: z.ZodPipe<z.ZodPipe<z.ZodOptional<z.ZodUnknown>, z.ZodTransform<number, unknown>>, z.ZodNumber>;
+    sshUser: z.ZodDefault<z.ZodString>;
+    authType: z.ZodDefault<z.ZodEnum<{
+        key: "key";
+        password: "password";
+    }>>;
+    sshKey: z.ZodOptional<z.ZodString>;
+    sshPassword: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ServerSshTest = z.infer<typeof serverSshTest>;
+export declare const serverSshBootstrap: z.ZodObject<{
+    name: z.ZodString;
+    host: z.ZodString;
+    sshPort: z.ZodPipe<z.ZodPipe<z.ZodOptional<z.ZodUnknown>, z.ZodTransform<number, unknown>>, z.ZodNumber>;
+    sshUser: z.ZodDefault<z.ZodString>;
+    authType: z.ZodDefault<z.ZodEnum<{
+        key: "key";
+        password: "password";
+    }>>;
+    sshKey: z.ZodOptional<z.ZodString>;
+    sshPassword: z.ZodOptional<z.ZodString>;
+    installDocker: z.ZodDefault<z.ZodBoolean>;
+    agentPort: z.ZodPipe<z.ZodPipe<z.ZodOptional<z.ZodUnknown>, z.ZodTransform<number, unknown>>, z.ZodNumber>;
+}, z.core.$strip>;
+export type ServerSshBootstrap = z.infer<typeof serverSshBootstrap>;
+export interface ServerSshTestResult {
+    ok: boolean;
+    message: string;
+    os?: string;
+    dockerInstalled?: boolean;
+    dockerVersion?: string;
+    latencyMs?: number;
+}
+export interface ServerBootstrapStep {
+    step: 'connecting' | 'os_detect' | 'docker_check' | 'docker_install' | 'agent_deploy' | 'verify' | 'done' | 'error';
+    status: 'pending' | 'running' | 'success' | 'failed';
+    message: string;
+    timestamp: string;
+}
+export interface ServerBootstrapResult {
+    ok: boolean;
+    serverId?: number;
+    serverName?: string;
+    steps: ServerBootstrapStep[];
+    logs: string[];
+    error?: string;
+}
+/**
+ * The cron expression itself is validated with croner at the route (the
+ * schema package has no cron dependency); a non-string `command` is ignored
+ * (empty string) as before.
+ */
+export declare const jobCreate: z.ZodObject<{
+    name: z.ZodString;
+    cron: z.ZodString;
+    kind: z.ZodDefault<z.ZodEnum<{
+        deploy: "deploy";
+        exec: "exec";
+    }>>;
+    command: z.ZodPipe<z.ZodOptional<z.ZodUnknown>, z.ZodTransform<string, unknown>>;
+    enabled: z.ZodPipe<z.ZodOptional<z.ZodUnknown>, z.ZodTransform<boolean, unknown>>;
+}, z.core.$strip>;
+export type JobCreate = z.infer<typeof jobCreate>;
+/** Blank strings are accepted and treated as "no change"/cleared by the route. */
+export declare const jobPatch: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    cron: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        deploy: "deploy";
+        exec: "exec";
+    }>>;
+    command: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type JobPatch = z.infer<typeof jobPatch>;
+/**
+ * Query params arrive as strings: any `kind` other than "memory" reads as
+ * "cpu", and an unusable `minutes` falls back to 60 (clamped to 1..1440).
+ */
+export declare const metricQuery: z.ZodObject<{
+    kind: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<"cpu" | "memory", string | undefined>>;
+    minutes: z.ZodPipe<z.ZodOptional<z.ZodUnknown>, z.ZodTransform<number, unknown>>;
+}, z.core.$strip>;
+export type MetricQuery = z.infer<typeof metricQuery>;
+/** Serialized alert rule as returned by GET/PATCH /v1/alerts. */
+export interface AlertRule {
+    id: number;
+    serviceId: number | null;
+    name: string;
+    metric: 'cpu' | 'memory' | 'cert-expiry';
+    operator: '>' | '<';
+    threshold: number;
+    durationWindows: number;
+    enabled: boolean;
+    status: 'ok' | 'breaching' | 'firing';
+    lastValue: number | null;
+    firedAt: string | null;
+    createdAt: string;
+}
+/** Input for creating an alert rule — defaults optional (zod applies them server-side). */
+export type CreateAlertRuleInput = z.input<typeof alertRuleCreate>;
+/** One audit-log entry (activity feed). `meta` carries request context (ip/ua). */
+export interface ActivityEntry {
+    id: number;
+    userId: number | null;
+    userName?: string | null;
+    userEmail?: string | null;
+    action: string;
+    entity: string | null;
+    meta: Record<string, unknown> | null;
+    ts: string;
+}
+export interface TraefikStatus {
+    running: boolean;
+    version: string | null;
+    versionLatest: string | null;
+    outdated: boolean;
+    uptime: string | null;
+    ports: {
+        http: number;
+        https: number;
+    };
+    configDir: string;
+}
+export interface TraefikCertificate {
+    domain: string;
+    expiresAt: string | null;
+    daysUntilExpiry: number | null;
+    issuer: string | null;
+}
+export interface TraefikRouter {
+    name: string;
+    rule: string;
+    service: string;
+    entryPoints: string[];
+    tls: boolean;
+    middleware: string[];
+}
+export interface TraefikService {
+    name: string;
+    url: string;
+    loadBalancer: string;
+}
+export interface TraefikMiddleware {
+    name: string;
+    type: string;
+    config: Record<string, unknown>;
+}
+export interface TraefikInfo {
+    status: TraefikStatus;
+    certificates: TraefikCertificate[];
+    routers: TraefikRouter[];
+    services: TraefikService[];
+    middlewares: TraefikMiddleware[];
+}
+export interface DatabaseDetail {
+    id: number;
+    projectId: number | null;
+    name: string;
+    slug: string;
+    engine: string;
+    version: string | null;
+    status: string;
+    host: string | null;
+    port: number | null;
+    username: string | null;
+    database: string | null;
+    connectionString: string | null;
+    containerName?: string | null;
+    containerId?: string | null;
+    volumeName?: string | null;
+    cpuShares?: number | null;
+    memLimitMb?: number | null;
+    webGuiEnabled?: boolean | null;
+    webGuiPort?: number | null;
+    extensions?: string[];
+    attachedServices: Array<{
+        id: number;
+        name: string;
+        slug: string;
+    }>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DatabaseCredentials {
+    engine: string;
+    username: string | null;
+    password: string;
+    database: string | null;
+    internalHost: string | null;
+    internalPort: number | null;
+    connectionString: string;
+}
+export declare const demoSeedResult: z.ZodObject<{
+    ok: z.ZodBoolean;
+    projectId: z.ZodNumber;
+    projectName: z.ZodString;
+    services: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        type: z.ZodString;
+        status: z.ZodString;
+        port: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    database: z.ZodNullable<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        engine: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DemoSeedResult = z.infer<typeof demoSeedResult>;
+//# sourceMappingURL=management.d.ts.map

package/dist/management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../src/management.ts"],"names":[],"mappings":"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"}