@kici-dev/orchestrator 0.14.2 → 0.16.0

package/dist/sources/source-manager.d.ts

@@ -11,19 +11,7 @@
 import type pg from 'pg';
 import { ProviderRegistry } from '../provider-registry.js';
 import type { ProviderSource } from '../entry-helpers.js';
-import { OrchestratorMode } from '@kici-dev/engine';
 import type { SourceStore } from './source-store.js';
-/**
- * Operator-facing error for a GitHub-App source under `observed` mode. Shared
- * by the startup assertion and the admin source-create route so both paths give
- * the same remediation.
- */
-export declare const OBSERVED_GITHUB_APP_SOURCE_ERROR: string;
-/** Thrown at startup when an observed-mode orchestrator holds GitHub-App sources. */
-export declare class ObservedGithubAppSourcesError extends Error {
-    readonly count: number;
-    constructor(count: number);
-}
 /**
  * Options for creating a SourceManager.
  */
@@ -39,13 +27,6 @@ export interface SourceManagerOptions {
     }) => void;
     /** Debounce interval in ms for coalescing rapid changes. Default: 200. */
     debounceMs?: number;
-    /**
-     * Orchestrator operating mode. In `observed` mode the manager refuses to
-     * start when the `sources` table holds any GitHub-App row — those are
-     * Platform-relayed by construction and an observed orchestrator never
-     * accepts a relay. Omitted (undefined) imposes no mode constraint.
-     */
-    mode?: OrchestratorMode;
 }
 /**
  * Manages webhook sources from the database with hot reload support.
@@ -84,11 +65,6 @@ export declare class SourceManager {
     start(): Promise<ProviderRegistry>;
     /** Stop listening and release the dedicated pg client. */
     stop(): Promise<void>;
-    /**
-     * Fail fast when an observed-mode orchestrator holds GitHub-App sources. The
-     * `sources` table is GitHub-App-only, so any row is a relay-type source.
-     */
-    private assertNoGithubAppSourcesInObservedMode;
     private scheduleReload;
     /** Reload sources from DB and rebuild the ProviderRegistry. */
     reload(): Promise<void>;

package/dist/sources/webhook-url-resolvers.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Every webhook-URL decision the orchestrator makes for a GitHub-App source,
+ * by operating mode. Pure functions: the entry points (`server.ts`,
+ * `standalone.ts`) pass in the mode, the public base, the org and the Platform
+ * values, so each rule is unit-tested here once.
+ */
+import { z } from 'zod';
+import { OrchestratorMode } from '@kici-dev/engine';
+/** Why a webhook URL could not be resolved. The CLI maps each to a reason and a hint. */
+export declare const WebhookUrlNote: z.ZodEnum<{
+    "no-public-url": "no-public-url";
+    "org-not-identified": "org-not-identified";
+    "platform-no-public-url": "platform-no-public-url";
+    "platform-unavailable": "platform-unavailable";
+    "platform-url-unknown": "platform-url-unknown";
+    "resolve-failed": "resolve-failed";
+    "resolver-unavailable": "resolver-unavailable";
+    "unsupported-provider": "unsupported-provider";
+}>;
+export type WebhookUrlNote = z.infer<typeof WebhookUrlNote>;
+export interface WebhookUrlResolution {
+    webhookUrl: string | null;
+    webhookNote?: WebhookUrlNote;
+}
+/** Org segment an orchestrator with no Platform org puts in its URLs. Neither route checks it. */
+export declare const DEFAULT_ORG_SEGMENT = "__default__";
+export interface AddedSourceUrlInput {
+    mode: OrchestratorMode;
+    webhookPublicUrl: string | undefined;
+    /** The Platform org this orchestrator authenticated as, when known. */
+    orgId: string | undefined;
+    sourceId: string;
+    /** Push the full source list to the Platform; resolves the ack's URL for this source. */
+    registerAndAwait: () => Promise<string | null>;
+    onRegisterError: (err: unknown) => void;
+}
+/** The URL `kici-admin source add github` prints for a freshly added source. */
+export declare function resolveAddedGithubSourceUrl(input: AddedSourceUrlInput): Promise<WebhookUrlResolution>;
+export interface ManifestUrlInput {
+    mode: OrchestratorMode;
+    webhookPublicUrl: string | undefined;
+    orgId: string | undefined;
+    /** `auth.success.githubWebhookUrl`; undefined when the Platform did not send it. */
+    platformGithubWebhookUrl: string | null | undefined;
+}
+/**
+ * The org-scoped URL the manifest flow bakes into a new App, before the App
+ * (and so the source id) exists. Platform and hybrid point the App at the
+ * hosted Platform; observed and independent at this orchestrator's
+ * org-scoped direct route.
+ */
+export declare function resolveManifestGithubWebhookUrl(input: ManifestUrlInput): WebhookUrlResolution;
+/** The direct-ingress URL `kici-admin source list` prints for a GitHub source, or null. */
+export declare function resolveListedGithubIngressUrl(input: {
+    mode: OrchestratorMode;
+    webhookPublicUrl: string | undefined;
+    orgId: string | undefined;
+    sourceId: string;
+}): string | null;
+//# sourceMappingURL=webhook-url-resolvers.d.ts.map