@oscharko-dev/keiko-server 0.2.0

package/dist/relationship-handlers.d.ts

@@ -0,0 +1,191 @@
+import type { IncomingMessage } from "node:http";
+import type { RelationshipLifecycleState, RelationshipObjectKind, RelationshipType } from "@oscharko-dev/keiko-contracts";
+import type { RouteContext, RouteResult } from "./routes.js";
+import { STREAMING } from "./routes.js";
+import type { UiHandlerDeps } from "./deps.js";
+import { type DependencyWalkResult, type RelationshipHealthFindings, type RelationshipScope, type StoredRelationship } from "./store/relationships.js";
+import type { RelationshipAuditEntryRow, RelationshipAuditKind } from "./store/relationship-audit.js";
+export type RelationshipScopeResolver = (req: IncomingMessage) => {
+    readonly workspaceId: string;
+} | undefined;
+export interface RelationshipStore {
+    createRelationship(input: CreateRelationshipInput): {
+        readonly relationship: StoredRelationship;
+        readonly etag: string;
+    };
+    getRelationship(workspaceId: string, id: string): StoredRelationship | undefined;
+    getEtag(workspaceId: string, id: string): string | undefined;
+    listRelationships(query: ListQuery): ListResult;
+    updateLifecycle(args: UpdateLifecycleInput): {
+        readonly relationship: StoredRelationship;
+        readonly etag: string;
+    };
+    reconnect(args: ReconnectInput): {
+        readonly relationship: StoredRelationship;
+        readonly etag: string;
+    };
+    walkDependencies(args: WalkArgs): DependencyWalkResult;
+    computeImpact(args: ImpactArgs): DependencyWalkResult;
+    graphHealth(workspaceId: string): GraphHealth;
+    lifecycleHistory(workspaceId: string, id: string): readonly LifecycleHistoryRow[];
+    recordAuditEntry(input: AuditEntryInput): RelationshipAuditEntryRow;
+}
+export interface CreateRelationshipInput {
+    readonly workspaceId: string;
+    readonly scope: RelationshipScope;
+    readonly type: RelationshipType;
+    readonly source: {
+        readonly kind: RelationshipObjectKind;
+        readonly id: string;
+    };
+    readonly target: {
+        readonly kind: RelationshipObjectKind;
+        readonly id: string;
+    };
+    readonly lifecycleState: RelationshipLifecycleState;
+    readonly confidence?: number | undefined;
+    readonly summary?: string | undefined;
+}
+export interface ListQuery {
+    readonly workspaceId: string;
+    readonly sourceKind?: RelationshipObjectKind | undefined;
+    readonly sourceId?: string | undefined;
+    readonly targetKind?: RelationshipObjectKind | undefined;
+    readonly targetId?: string | undefined;
+    readonly type?: RelationshipType | undefined;
+    readonly lifecycle?: RelationshipLifecycleState | undefined;
+    readonly limit: number;
+}
+export interface ListResult {
+    readonly entries: readonly StoredRelationship[];
+    readonly truncated: boolean;
+    readonly nextCursor: string | undefined;
+}
+export interface UpdateLifecycleInput {
+    readonly workspaceId: string;
+    readonly id: string;
+    readonly currentEtag: string;
+    readonly to: RelationshipLifecycleState;
+    readonly summary?: string | undefined;
+}
+export interface ReconnectInput {
+    readonly workspaceId: string;
+    readonly id: string;
+    readonly currentEtag: string;
+    readonly target: {
+        readonly kind: RelationshipObjectKind;
+        readonly id: string;
+    };
+    readonly summary?: string | undefined;
+}
+export interface WalkArgs {
+    readonly workspaceId: string;
+    readonly originId: string;
+    readonly direction: "outgoing" | "incoming" | "both";
+    readonly maxDepth: number;
+    readonly maxNodes: number;
+    readonly maxRelationships: number;
+}
+export interface ImpactArgs {
+    readonly workspaceId: string;
+    readonly endpoint: {
+        readonly kind: RelationshipObjectKind;
+        readonly id: string;
+    };
+    readonly direction: "outgoing" | "incoming" | "both";
+    readonly maxDepth: number;
+    readonly maxNodes: number;
+    readonly maxRelationships: number;
+}
+export interface GraphHealth {
+    readonly checkedAt: number;
+    readonly totals: Readonly<Record<RelationshipLifecycleState, number>>;
+    readonly truncated: boolean;
+    readonly findings: RelationshipHealthFindings;
+}
+export interface LifecycleHistoryRow {
+    readonly fromState: RelationshipLifecycleState;
+    readonly toState: RelationshipLifecycleState;
+    readonly occurredAt: number;
+    readonly summary?: string | undefined;
+}
+export interface AuditEntryInput {
+    readonly workspaceId: string;
+    readonly kind: RelationshipAuditKind;
+    readonly relationshipId?: string | undefined;
+    readonly actor: {
+        readonly surface: "system" | "inspector" | "chat";
+        readonly redactedActorId: string;
+    };
+    readonly summary: string;
+    readonly payload: Readonly<Record<string, unknown>>;
+}
+export interface RelationshipHandlerDeps {
+    readonly scopeResolver: RelationshipScopeResolver;
+    readonly store: RelationshipStore;
+}
+export declare function _resetIdempotencyStoreForTests(): void;
+declare function hashBody(raw: string): string;
+interface ProposalInput {
+    readonly type: RelationshipType;
+    readonly source: {
+        readonly kind: RelationshipObjectKind;
+        readonly id: string;
+    };
+    readonly target: {
+        readonly kind: RelationshipObjectKind;
+        readonly id: string;
+    };
+    readonly scope: RelationshipScope;
+    readonly summary?: string | undefined;
+}
+declare function parseProposal(body: Record<string, unknown>, workspaceId: string): ProposalInput;
+export interface RelationshipHandlerSet {
+    readonly handleValidate: (ctx: RouteContext, deps: UiHandlerDeps) => Promise<RouteResult>;
+    readonly handleCreate: (ctx: RouteContext, deps: UiHandlerDeps) => Promise<RouteResult>;
+    readonly handleList: (ctx: RouteContext, deps: UiHandlerDeps) => Promise<RouteResult>;
+    readonly handleGet: (ctx: RouteContext, deps: UiHandlerDeps) => Promise<RouteResult>;
+    readonly handlePatch: (ctx: RouteContext, deps: UiHandlerDeps) => Promise<RouteResult>;
+    readonly handleDelete: (ctx: RouteContext, deps: UiHandlerDeps) => Promise<RouteResult>;
+    readonly handleDependencies: (ctx: RouteContext, deps: UiHandlerDeps) => Promise<RouteResult>;
+    readonly handleImpact: (ctx: RouteContext, deps: UiHandlerDeps) => Promise<RouteResult>;
+    readonly handleExplain: (ctx: RouteContext, deps: UiHandlerDeps) => Promise<RouteResult>;
+    readonly handleHealth: (ctx: RouteContext, deps: UiHandlerDeps) => Promise<RouteResult>;
+    readonly handleEvents: (ctx: RouteContext, deps: UiHandlerDeps) => RouteResult | typeof STREAMING;
+}
+declare function handleValidateImpl(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+declare function handleCreateImpl(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+declare function handleListImpl(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+declare function handleGetImpl(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+declare function handlePatchImpl(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+declare function handleDeleteImpl(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+declare function handleDependenciesImpl(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+declare function handleImpactImpl(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+declare function handleExplainImpl(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+declare function handleHealthImpl(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+declare function handleEventsImpl(ctx: RouteContext, deps: UiHandlerDeps): RouteResult | typeof STREAMING;
+export declare const handleRelationshipValidate: typeof handleValidateImpl;
+export declare const handleRelationshipCreate: typeof handleCreateImpl;
+export declare const handleRelationshipList: typeof handleListImpl;
+export declare const handleRelationshipGet: typeof handleGetImpl;
+export declare const handleRelationshipPatch: typeof handlePatchImpl;
+export declare const handleRelationshipDelete: typeof handleDeleteImpl;
+export declare const handleRelationshipDependencies: typeof handleDependenciesImpl;
+export declare const handleRelationshipImpact: typeof handleImpactImpl;
+export declare const handleRelationshipExplain: typeof handleExplainImpl;
+export declare const handleRelationshipHealth: typeof handleHealthImpl;
+export declare const handleRelationshipEvents: typeof handleEventsImpl;
+export declare const _testing: {
+    readonly parseProposal: typeof parseProposal;
+    readonly hashBody: typeof hashBody;
+};
+import type { DatabaseSync } from "node:sqlite";
+export interface CreateRelationshipStorePortOptions {
+    readonly db: DatabaseSync;
+    readonly redactString: (value: string) => string;
+    readonly now?: (() => number) | undefined;
+    readonly newId?: (() => string) | undefined;
+}
+export declare function createRelationshipStorePort(options: CreateRelationshipStorePortOptions): RelationshipStore;
+export {};
+//# sourceMappingURL=relationship-handlers.d.ts.map

package/dist/relationship-handlers.d.ts.map

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

package/dist/routes.d.ts

@@ -0,0 +1,37 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { UiHandlerDeps } from "./deps.js";
+export interface ApiError {
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+    };
+}
+export interface RouteResult {
+    readonly status: number;
+    readonly body: unknown;
+}
+export declare const STREAMING: unique symbol;
+export type HandlerOutcome = RouteResult | typeof STREAMING;
+export interface RouteContext {
+    readonly req: IncomingMessage;
+    readonly res: ServerResponse;
+    readonly params: Readonly<Record<string, string>>;
+    readonly url: URL;
+}
+export type RouteHandler = (ctx: RouteContext, deps: UiHandlerDeps) => HandlerOutcome | Promise<HandlerOutcome>;
+export interface RouteDefinition {
+    readonly method: string;
+    readonly pattern: string;
+    readonly handler: RouteHandler;
+}
+export declare const API_ROUTES: readonly RouteDefinition[];
+export interface RouteMatch {
+    readonly definition: RouteDefinition;
+    readonly params: Readonly<Record<string, string>>;
+}
+export declare function matchRoute(method: string, pathname: string): RouteMatch | "method-not-allowed" | undefined;
+export declare function isApiPath(pathname: string): boolean;
+export declare function errorBody(code: string, message: string): ApiError;
+export declare function notFoundBody(): ApiError;
+export declare function methodNotAllowedBody(): ApiError;
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAmK/C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE;AAID,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,SAAS,eAAsB,CAAC;AAC7C,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,OAAO,SAAS,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAElD,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,aAAa,KAChB,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAUD,eAAO,MAAM,UAAU,EAAE,SAAS,eAAe,EA4YhD,CAAC;AA6BF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAKD,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,UAAU,GAAG,oBAAoB,GAAG,SAAS,CA2B/C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAEjE;AAED,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED,wBAAgB,oBAAoB,IAAI,QAAQ,CAE/C"}