@ddtcorex/dsh-maestro-config 0.1.0

package/src/client/settings-nav-icon.ts

@@ -0,0 +1,68 @@
+/**
+ * Mark this plugin's row in the DSH settings navigation so a style block can
+ * replace the shell's fallback gear with the maestro glyph.
+ *
+ * DSH 0.1.x projects only `id`, `order`, and `label` from a `settings.section`
+ * registration and picks icons from a closed built-in list, so each external
+ * plugin identifies its own localized row by visible text after the dialog
+ * mounts. The marker owns no shell structure and is removed on disposal.
+ */
+
+export const SETTINGS_NAV_MARKER = 'data-maestro-settings-nav'
+
+/** Minimal DOM surface used here; tests inject a stub instead of `document`. */
+/** The two DOM iteration shapes this module touches (querySelector results). */
+type NodeSeq = Iterable<Element> & { forEach(fn: (el: Element) => void): unknown }
+
+interface DomScope {
+  querySelectorAll(selector: string): NodeSeq
+}
+
+type ElementLike = Element & {
+  setAttribute(name: string, value: string): void
+  removeAttribute(name: string): void
+}
+
+export function registerSettingsNavIcon(
+  label: () => string,
+  root?: DomScope,
+): () => void {
+  if (typeof document === 'undefined' && root === undefined) {
+    // Node-side import safety (tests inject a stub root instead).
+    return () => {}
+  }
+  const scope = (root ?? document) as DomScope
+
+  let disposed = false
+
+  const sync = () => {
+    if (disposed) return
+    const currentLabel = label().trim()
+    const buttons = scope.querySelectorAll('[role="dialog"] nav button')
+    for (const button of Array.from(buttons)) {
+      const el = button as ElementLike
+      const matches =
+        currentLabel.length > 0 &&
+        button.textContent != null &&
+        button.textContent.trim() === currentLabel
+      if (matches) el.setAttribute(SETTINGS_NAV_MARKER, '')
+      else el.removeAttribute(SETTINGS_NAV_MARKER)
+    }
+  }
+
+  sync()
+
+  let observer: MutationObserver | null = null
+  if (typeof MutationObserver !== 'undefined') {
+    observer = new MutationObserver(sync)
+    observer.observe(document.body, { childList: true, subtree: true, characterData: true })
+  }
+
+  return () => {
+    disposed = true
+    if (observer !== null) observer.disconnect()
+    for (const element of Array.from(scope.querySelectorAll(`[${SETTINGS_NAV_MARKER}]`))) {
+      ;(element as ElementLike).removeAttribute(SETTINGS_NAV_MARKER)
+    }
+  }
+}

package/src/client/webhook-secret.ts

@@ -0,0 +1,13 @@
+const BASE64URL_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_'
+
+/** Generate an opaque 256-bit secret suitable for GitLab's webhook token. */
+export function generateWebhookSecret(randomValues = crypto.getRandomValues.bind(crypto)) {
+  const bytes = randomValues(new Uint8Array(32))
+  return Array.from(bytes, (byte) => BASE64URL_ALPHABET[byte & 0b00111111]).join('')
+}
+
+/** GitLab's Merge Request webhook endpoint for the configured public hostname. */
+export function gitlabWebhookUrl(hostname?: string) {
+  const authority = hostname?.trim().replace(/^https?:\/\//, '').replace(/\/+$/, '') || '<your-hostname>'
+  return `https://${authority}/hooks/gitlab-mr`
+}

package/src/host/index.ts

@@ -0,0 +1,58 @@
+import type {} from '@deepseek-ai/dsh-client-connection'
+import type { Context } from '@deepseek-ai/cordis'
+import type { RpcErrorDetailsMap, RpcResult } from '@deepseek-ai/dsh-host-apiproxy/api'
+import { createMaestroConfigService, type MaestroConfigService } from './service.ts'
+
+export const name = 'maestro-config'
+export const inject = ['connection']
+
+const RPC_CHANNEL = '/dsh-maestro-config'
+
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    maestroConfig: MaestroConfigService
+  }
+}
+
+function ok<T>(value: T): RpcResult<T> {
+  return { ok: true, value }
+}
+
+function fail(message: string): RpcResult<never> {
+  return {
+    ok: false,
+    error: {
+      code: 'bad-request',
+      message,
+      // Synthetic details: app-level validation error shoehorned into DSH's
+      // shared RPC error taxonomy (same approach across maestro packages).
+      details: { issues: [{ message }] } as RpcErrorDetailsMap['bad-request'],
+    },
+  }
+}
+
+/** Publish maestroConfig over the shared store + loopback RPC for clients. */
+export function apply(ctx: Context): void {
+  const svc = createMaestroConfigService()
+  ctx.provide('maestroConfig', svc)
+  ctx.effect(() =>
+    ctx.connection.rpc.handle(RPC_CHANNEL, async (endpoint: string, payload: unknown): Promise<RpcResult<unknown>> => {
+      const body = (payload ?? {}) as { domain?: string; patch?: object }
+      if (endpoint === 'list') {
+        return ok({ domains: await svc.listDomains() })
+      }
+      if (endpoint === 'get') {
+        if (typeof body.domain !== 'string') return fail('domain (string) is required')
+        return ok(await svc.get(body.domain))
+      }
+      if (endpoint === 'set') {
+        if (typeof body.domain !== 'string' || typeof body.patch !== 'object' || body.patch === null) {
+          return fail('domain (string) and patch (object) are required')
+        }
+        await svc.set(body.domain, body.patch)
+        return ok(null)
+      }
+      return fail(`unknown endpoint: ${String(endpoint)}`)
+    }, { authority: 'loopback' })
+  )
+}

package/src/host/service.ts

@@ -0,0 +1,33 @@
+import * as lib from '@ddtcorex/dsh-maestro-config-lib'
+
+export interface MaestroConfigService {
+  /** Union of schema-registered domains and domains present in the store file. */
+  listDomains(): Promise<string[]>
+  get(domain: string): Promise<unknown>
+  /** Deep-merges the patch into the domain (same semantics as the lib). */
+  set(domain: string, patch: object): Promise<void>
+  onChange(cb: (domain: string) => void): () => void
+}
+
+/**
+ * Thin facade over @ddtcorex/dsh-maestro-config-lib. `dshHome` defaults to the
+ * lib's resolution (explicit > DSH_HOME env > ~/.dsh); tests inject a tmpdir.
+ */
+export function createMaestroConfigService(opts?: { dshHome?: string }): MaestroConfigService {
+  const libOpts = opts?.dshHome ? { dshHome: opts.dshHome } : undefined
+  return {
+    async listDomains() {
+      const doc = await lib.load(libOpts)
+      return [...new Set([...lib.definedDomains(), ...Object.keys(doc.domains)])]
+    },
+    async get(domain) {
+      return lib.get(domain, libOpts)
+    },
+    async set(domain, patch) {
+      await lib.set(domain, patch, libOpts)
+    },
+    onChange(cb) {
+      return lib.onChange(cb)
+    },
+  }
+}