OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

AI index

health.webhooks.ingest

Ingest and normalize health provider webhook payloads.

  • Type: operation (command)
  • Version: 1.0.0
  • Stability: experimental
  • Owners: @platform.integrations
  • Tags: health, webhooks, integrations
    • field.key.label
    health.webhooks.ingest
    field.version.label
    1.0.0
    field.type.label
    operation (command)
    field.title.label
    health.webhooks.ingest
    field.description.label

    Ingest and normalize health provider webhook payloads.

  • Type: operation (command)
  • Version: 1.0.0
  • Stability: experimental
  • Owners: @platform.integrations
  • Tags: health, webhooks, integrations
    • field.tags.label
    health,webhooks,integrations
    field.owners.label
    @platform.integrations
    field.stability.label
    experimental

    Ingest and normalize health provider webhook payloads.

    Goal

    Allow near-real-time updates for health entities while preserving deterministic ingestion.

    Context

    Triggered by configured webhook endpoints for official, aggregator, and unofficial connectors.

    Source Definition

    import {
	type AnyOperationSpec,
	defineCommand,
} from '@lssm-tech/lib.contracts-spec/operations';
import type { OperationSpecRegistry } from '@lssm-tech/lib.contracts-spec/operations/registry';
import { ScalarTypeEnum, SchemaModel } from '@lssm-tech/lib.schema';
import { HealthWebhookEventRecord } from '../models';
import { HEALTH_TELEMETRY_EVENTS } from '../telemetry';

export const HealthWebhookIngest = defineCommand({
	meta: {
		key: 'health.webhooks.ingest',
		version: '1.0.0',
		description: 'Ingest and normalize health provider webhook payloads.',
		goal: 'Allow near-real-time updates for health entities while preserving deterministic ingestion.',
		context:
			'Triggered by configured webhook endpoints for official, aggregator, and unofficial connectors.',
		owners: ['@platform.integrations'],
		tags: ['health', 'webhooks', 'integrations'],
		stability: 'experimental',
	},
	io: {
		input: HealthWebhookIngestInput,
		output: HealthWebhookIngestOutput,
	},
	policy: {
		auth: 'admin',
	},
	telemetry: {
		success: {
			event: { key: HEALTH_TELEMETRY_EVENTS.webhookReceived },
		},
		failure: {
			event: { key: HEALTH_TELEMETRY_EVENTS.webhookRejected },
		},
	},
});