@elevasis/core 0.22.0 → 0.24.0

package/src/integrations/webhook-endpoints/api-schemas.ts

@@ -1,103 +1,103 @@
-import { z } from 'zod'
-import { UuidSchema, NonEmptyStringSchema, PaginationSchema } from '../../platform/utils/validation'
-
-/**
- * Webhook Endpoint API Validation Schemas
- *
- * HTTP request/response validation for the webhook endpoints CRUD API.
- * These schemas are browser-safe and shared between API and frontend.
- *
- * Design notes:
- * - Request schemas use `.strict()` to reject unknown fields (mass assignment prevention)
- * - Response schemas do NOT use `.strict()` (allows forward-compatible additions)
- * - Update schema requires at least one field via `.refine()`
- */
-
-/**
- * Status enum for webhook endpoints
- */
-export const WebhookEndpointStatusSchema = z.enum(['active', 'paused'])
-
-/**
- * POST /api/webhook-endpoints - Create a new webhook endpoint
- *
- * The `key` and `id` are generated server-side and not accepted in the request.
- */
-export const CreateWebhookEndpointRequestSchema = z
-  .object({
-    /** User-facing label for the endpoint */
-    name: NonEmptyStringSchema,
-    /** Target workflow resourceId to invoke on inbound requests (can be set later) */
-    resourceId: NonEmptyStringSchema.optional(),
-    /** Optional description */
-    description: z.string().optional()
-  })
-  .strict()
-
-export type CreateWebhookEndpointRequest = z.infer<typeof CreateWebhookEndpointRequestSchema>
-
-/**
- * PATCH /api/webhook-endpoints/:id - Update an existing webhook endpoint
- *
- * At least one field must be provided.
- */
-export const UpdateWebhookEndpointRequestSchema = z
-  .object({
-    name: NonEmptyStringSchema.optional(),
-    description: z.string().optional(),
-    resourceId: NonEmptyStringSchema.optional(),
-    status: WebhookEndpointStatusSchema.optional()
-  })
-  .strict()
-  .refine(
-    (data) =>
-      data.name !== undefined ||
-      data.description !== undefined ||
-      data.resourceId !== undefined ||
-      data.status !== undefined,
-    { message: 'At least one field (name, description, resourceId, or status) must be provided' }
-  )
-
-export type UpdateWebhookEndpointRequest = z.infer<typeof UpdateWebhookEndpointRequestSchema>
-
-/**
- * Response shape for a single webhook endpoint.
- * NOT strict — response schemas allow extra fields for forward compatibility.
- */
-export const WebhookEndpointResponseSchema = z.object({
-  id: UuidSchema,
-  organizationId: UuidSchema,
-  key: z.string().optional(),
-  keyPrefix: z.string().nullable(),
-  name: z.string(),
-  description: z.string().nullable(),
-  resourceId: z.string().nullable(),
-  status: WebhookEndpointStatusSchema,
-  lastTriggeredAt: z.string().datetime().nullable(),
-  requestCount: z.number().int().min(0),
-  createdAt: z.string().datetime(),
-  updatedAt: z.string().datetime()
-})
-
-export type WebhookEndpointResponse = z.infer<typeof WebhookEndpointResponseSchema>
-
-/**
- * GET /api/webhook-endpoints - List webhook endpoints query params
- *
- * Extends standard pagination with optional status filter.
- */
-export const ListWebhookEndpointsQuerySchema = PaginationSchema.extend({
-  status: WebhookEndpointStatusSchema.optional()
-})
-
-export type ListWebhookEndpointsQuery = z.infer<typeof ListWebhookEndpointsQuerySchema>
-
-/**
- * Named collection of all webhook endpoint schemas for route registration
- */
-export const WebhookEndpointSchemas = {
-  CreateRequest: CreateWebhookEndpointRequestSchema,
-  UpdateRequest: UpdateWebhookEndpointRequestSchema,
-  Response: WebhookEndpointResponseSchema,
-  ListQuery: ListWebhookEndpointsQuerySchema
-}
+import { z } from 'zod'
+import { UuidSchema, NonEmptyStringSchema, PaginationSchema } from '../../platform/utils/validation'
+
+/**
+ * Webhook Endpoint API Validation Schemas
+ *
+ * HTTP request/response validation for the webhook endpoints CRUD API.
+ * These schemas are browser-safe and shared between API and frontend.
+ *
+ * Design notes:
+ * - Request schemas use `.strict()` to reject unknown fields (mass assignment prevention)
+ * - Response schemas do NOT use `.strict()` (allows forward-compatible additions)
+ * - Update schema requires at least one field via `.refine()`
+ */
+
+/**
+ * Status enum for webhook endpoints
+ */
+export const WebhookEndpointStatusSchema = z.enum(['active', 'paused'])
+
+/**
+ * POST /api/webhook-endpoints - Create a new webhook endpoint
+ *
+ * The `key` and `id` are generated server-side and not accepted in the request.
+ */
+export const CreateWebhookEndpointRequestSchema = z
+  .object({
+    /** User-facing label for the endpoint */
+    name: NonEmptyStringSchema,
+    /** Target workflow resourceId to invoke on inbound requests (can be set later) */
+    resourceId: NonEmptyStringSchema.optional(),
+    /** Optional description */
+    description: z.string().optional()
+  })
+  .strict()
+
+export type CreateWebhookEndpointRequest = z.infer<typeof CreateWebhookEndpointRequestSchema>
+
+/**
+ * PATCH /api/webhook-endpoints/:id - Update an existing webhook endpoint
+ *
+ * At least one field must be provided.
+ */
+export const UpdateWebhookEndpointRequestSchema = z
+  .object({
+    name: NonEmptyStringSchema.optional(),
+    description: z.string().optional(),
+    resourceId: NonEmptyStringSchema.optional(),
+    status: WebhookEndpointStatusSchema.optional()
+  })
+  .strict()
+  .refine(
+    (data) =>
+      data.name !== undefined ||
+      data.description !== undefined ||
+      data.resourceId !== undefined ||
+      data.status !== undefined,
+    { message: 'At least one field (name, description, resourceId, or status) must be provided' }
+  )
+
+export type UpdateWebhookEndpointRequest = z.infer<typeof UpdateWebhookEndpointRequestSchema>
+
+/**
+ * Response shape for a single webhook endpoint.
+ * NOT strict — response schemas allow extra fields for forward compatibility.
+ */
+export const WebhookEndpointResponseSchema = z.object({
+  id: UuidSchema,
+  organizationId: UuidSchema,
+  key: z.string().optional(),
+  keyPrefix: z.string().nullable(),
+  name: z.string(),
+  description: z.string().nullable(),
+  resourceId: z.string().nullable(),
+  status: WebhookEndpointStatusSchema,
+  lastTriggeredAt: z.string().datetime().nullable(),
+  requestCount: z.number().int().min(0),
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime()
+})
+
+export type WebhookEndpointResponse = z.infer<typeof WebhookEndpointResponseSchema>
+
+/**
+ * GET /api/webhook-endpoints - List webhook endpoints query params
+ *
+ * Extends standard pagination with optional status filter.
+ */
+export const ListWebhookEndpointsQuerySchema = PaginationSchema.extend({
+  status: WebhookEndpointStatusSchema.optional()
+})
+
+export type ListWebhookEndpointsQuery = z.infer<typeof ListWebhookEndpointsQuerySchema>
+
+/**
+ * Named collection of all webhook endpoint schemas for route registration
+ */
+export const WebhookEndpointSchemas = {
+  CreateRequest: CreateWebhookEndpointRequestSchema,
+  UpdateRequest: UpdateWebhookEndpointRequestSchema,
+  Response: WebhookEndpointResponseSchema,
+  ListQuery: ListWebhookEndpointsQuerySchema
+}

package/src/integrations/webhook-endpoints/types.ts

@@ -1,58 +1,58 @@
-/**
- * Webhook Endpoint Domain Types
- *
- * Browser-safe domain types for generic inbound webhook endpoints.
- * These are camelCase representations of the `webhook_endpoints` DB table.
- *
- * Transform from snake_case DB rows happens in the API service layer,
- * not here (per core-package.md conventions).
- */
-
-/**
- * Lifecycle status of a webhook endpoint.
- * - `active`: Endpoint accepts inbound requests and triggers the target workflow
- * - `paused`: Endpoint exists but rejects inbound requests with 404
- */
-export type WebhookEndpointStatus = 'active' | 'paused'
-
-/**
- * Generic inbound webhook endpoint domain type.
- *
- * Each endpoint gets a unique opaque URL (`/api/webhooks/inbound/:key`)
- * that maps to a target workflow resource within an organization.
- */
-export interface WebhookEndpoint {
-  /** UUID primary key */
-  id: string
-  /** Organization this endpoint belongs to */
-  organizationId: string
-  /**
-   * Unique opaque key used in the inbound URL.
-   * Format: `wh_` + 32 crypto-random hex chars (128 bits of entropy).
-   * This key IS the credential — it must be kept secret.
-   * Set ONLY on the return value of `create()` — undefined on list/get/getEndpointByKey responses.
-   */
-  key?: string
-  /**
-   * First 8 characters of the plaintext key for display and grep hints.
-   * Safe to show in list views — not sufficient to reconstruct the full key.
-   * Null on legacy rows that predate the key_hash migration.
-   */
-  keyPrefix: string | null
-  /** User-facing label (e.g., "Zapier → Lead Intake") */
-  name: string
-  /** Optional description for the endpoint */
-  description: string | null
-  /** Target workflow resourceId to invoke on inbound request, or null if not yet assigned */
-  resourceId: string | null
-  /** Whether the endpoint is accepting requests */
-  status: WebhookEndpointStatus
-  /** Timestamp of the most recent successful inbound request, or null */
-  lastTriggeredAt: string | null
-  /** Running total of inbound requests received */
-  requestCount: number
-  /** ISO 8601 creation timestamp */
-  createdAt: string
-  /** ISO 8601 last-updated timestamp */
-  updatedAt: string
-}
+/**
+ * Webhook Endpoint Domain Types
+ *
+ * Browser-safe domain types for generic inbound webhook endpoints.
+ * These are camelCase representations of the `webhook_endpoints` DB table.
+ *
+ * Transform from snake_case DB rows happens in the API service layer,
+ * not here (per core-package.md conventions).
+ */
+
+/**
+ * Lifecycle status of a webhook endpoint.
+ * - `active`: Endpoint accepts inbound requests and triggers the target workflow
+ * - `paused`: Endpoint exists but rejects inbound requests with 404
+ */
+export type WebhookEndpointStatus = 'active' | 'paused'
+
+/**
+ * Generic inbound webhook endpoint domain type.
+ *
+ * Each endpoint gets a unique opaque URL (`/api/webhooks/inbound/:key`)
+ * that maps to a target workflow resource within an organization.
+ */
+export interface WebhookEndpoint {
+  /** UUID primary key */
+  id: string
+  /** Organization this endpoint belongs to */
+  organizationId: string
+  /**
+   * Unique opaque key used in the inbound URL.
+   * Format: `wh_` + 32 crypto-random hex chars (128 bits of entropy).
+   * This key IS the credential — it must be kept secret.
+   * Set ONLY on the return value of `create()` — undefined on list/get/getEndpointByKey responses.
+   */
+  key?: string
+  /**
+   * First 8 characters of the plaintext key for display and grep hints.
+   * Safe to show in list views — not sufficient to reconstruct the full key.
+   * Null on legacy rows that predate the key_hash migration.
+   */
+  keyPrefix: string | null
+  /** User-facing label (e.g., "Zapier → Lead Intake") */
+  name: string
+  /** Optional description for the endpoint */
+  description: string | null
+  /** Target workflow resourceId to invoke on inbound request, or null if not yet assigned */
+  resourceId: string | null
+  /** Whether the endpoint is accepting requests */
+  status: WebhookEndpointStatus
+  /** Timestamp of the most recent successful inbound request, or null */
+  lastTriggeredAt: string | null
+  /** Running total of inbound requests received */
+  requestCount: number
+  /** ISO 8601 creation timestamp */
+  createdAt: string
+  /** ISO 8601 last-updated timestamp */
+  updatedAt: string
+}

package/src/knowledge/README.md

@@ -1,32 +1,33 @@
-# @elevasis/core/knowledge
-
-Pure query layer over the organization graph. Browser-safe (no Node APIs); shared by the SDK CLI, platform CLI, and the `@elevasis/ui/knowledge` browser.
-
-## Surface
-
-| Export                                        | Purpose                                                                                                                             |
-| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
-| `byFeature(graph, featureId, knowledgeNodes)` | Knowledge nodes that govern the given feature.                                                                                      |
-| `byKind(graph, kind, knowledgeNodes)`         | Filter knowledge nodes by `OrgKnowledgeKind`.                                                                                       |
-| `byOwner(graph, ownerId, knowledgeNodes)`     | Knowledge nodes whose `ownerIds` includes the given owner.                                                                          |
-| `governs(graph, nodeId)`                      | Outgoing `governs` targets (governed-feature ids) from a knowledge node.                                                            |
-| `governedBy(graph, nodeId)`                   | Incoming `governs` sources (governing knowledge-node ids) into a feature.                                                           |
-| `parsePath(pathString)`                       | Parse `/by-feature/$id`, `/by-kind/$kind`, `/by-owner/$id`, `/graph/$id/{governs,governed-by}`, or `/$id`. Throws on invalid input. |
-| `formatText`, `formatJson`, `formatIdsOnly`   | Output formatters used by the `knowledge:*` CLI subcommands.                                                                        |
-
-## Path syntax
-
-```
-/by-feature/<featureId>
-/by-kind/<playbook|strategy|reference>
-/by-owner/<ownerId>
-/graph/<nodeId>/governs
-/graph/<nodeId>/governed-by
-/<nodeId>
-```
-
-## JSON envelope
-
-`formatJson` returns `{ path, mount, args, results }` — the same wrapped envelope used by `pnpm exec elevasis knowledge:ls --json` and `pnpm exec elevasis-sdk knowledge:ls --json`.
-
-`governs` and `governedBy` accept either bare or graph-namespaced ids (`knowledge.foo` or `knowledge:knowledge.foo`).
+# @elevasis/core/knowledge
+
+Pure query layer over the organization graph. Browser-safe (no Node APIs); shared by the SDK CLI, platform CLI, and the `@elevasis/ui/knowledge` browser.
+
+## Surface
+
+| Export                                        | Purpose                                                                                                                             |
+| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `bySystem(graph, systemId, knowledgeNodes)` | Knowledge nodes that govern the given system.                                                                                      |
+| `byKind(graph, kind, knowledgeNodes)`         | Filter knowledge nodes by `OrgKnowledgeKind`.                                                                                       |
+| `byOwner(graph, ownerId, knowledgeNodes)`     | Knowledge nodes whose `ownerIds` includes the given owner.                                                                          |
+| `governs(graph, nodeId)`                      | Outgoing `governs` targets (governed-system ids) from a knowledge node.                                                            |
+| `governedBy(graph, nodeId)`                   | Incoming `governs` sources (governing knowledge-node ids) into a system.                                                           |
+| `parsePath(pathString)`                       | Parse `/by-system/$id`, `/by-kind/$kind`, `/by-owner/$id`, `/graph/$id/{governs,governed-by}`, or `/$id`. Throws on invalid input. |
+| `formatText`, `formatJson`, `formatIdsOnly`   | Output formatters used by the `knowledge:*` CLI subcommands.                                                                        |
+
+## Path syntax
+
+```
+/by-system/<systemId>
+/by-kind/<playbook|strategy|reference>
+/by-owner/<ownerId>
+/graph/<nodeId>/governs
+/graph/<nodeId>/governed-by
+/<nodeId>
+```
+
+## JSON envelope
+
+`formatJson` returns `{ path, mount, args, results }` — the same wrapped envelope used by `pnpm exec elevasis knowledge:ls --json` and `pnpm exec elevasis-sdk knowledge:ls --json`.
+
+`governs` and `governedBy` accept either bare or graph-namespaced ids (`knowledge.foo` or `knowledge:knowledge.foo`).
+