@contractspec/module.workspace 1.44.0

package/dist/types/spec-types.d.ts

@@ -0,0 +1,345 @@
+//#region src/types/spec-types.d.ts
+/**
+ * Core spec type definitions.
+ * Extracted from cli-contractspec/src/types.ts
+ */
+type SpecType = 'operation' | 'event' | 'presentation' | 'form' | 'feature' | 'workflow' | 'data-view' | 'migration' | 'telemetry' | 'experiment' | 'app-config' | 'integration' | 'knowledge';
+type OpKind = 'command' | 'query';
+type PresentationKind = 'web_component' | 'markdown' | 'data';
+type Stability = 'experimental' | 'beta' | 'stable' | 'deprecated';
+type StepType = 'human' | 'automation' | 'decision';
+interface BaseSpecData {
+  name: string;
+  version: number;
+  description: string;
+  owners: string[];
+  tags: string[];
+  stability: Stability;
+}
+interface OperationSpecData extends BaseSpecData {
+  kind: OpKind;
+  goal: string;
+  context: string;
+  hasInput: boolean;
+  hasOutput: boolean;
+  auth: 'anonymous' | 'user' | 'admin';
+  flags: string[];
+  emitsEvents: boolean;
+}
+interface EventSpecData extends BaseSpecData {
+  piiFields: string[];
+}
+interface PresentationSpecData extends BaseSpecData {
+  presentationKind: PresentationKind;
+}
+type FormSpecData = BaseSpecData;
+interface FeatureSpecData extends BaseSpecData {
+  key: string;
+  operations: {
+    name: string;
+    version: number;
+  }[];
+  events: {
+    name: string;
+    version: number;
+  }[];
+  presentations: {
+    name: string;
+    version: number;
+  }[];
+}
+interface WorkflowStepData {
+  id: string;
+  label: string;
+  type: StepType;
+  description?: string;
+  operation?: {
+    name: string;
+    version: number;
+  };
+  form?: {
+    key: string;
+    version: number;
+  };
+}
+interface WorkflowTransitionData {
+  from: string;
+  to: string;
+  condition?: string;
+}
+interface WorkflowSpecData extends BaseSpecData {
+  title: string;
+  domain: string;
+  entryStepId?: string;
+  steps: WorkflowStepData[];
+  transitions: WorkflowTransitionData[];
+  policyFlags: string[];
+}
+type DataViewKind = 'list' | 'detail' | 'table' | 'grid';
+interface DataViewFieldData {
+  key: string;
+  label: string;
+  dataPath: string;
+  format?: string;
+  sortable?: boolean;
+  filterable?: boolean;
+}
+interface DataViewSpecData extends BaseSpecData {
+  title: string;
+  domain: string;
+  entity: string;
+  kind: DataViewKind;
+  primaryOperation: {
+    name: string;
+    version: number;
+  };
+  itemOperation?: {
+    name: string;
+    version: number;
+  };
+  fields: DataViewFieldData[];
+  primaryField?: string;
+  secondaryFields?: string[];
+}
+type TelemetryPrivacy = 'public' | 'internal' | 'pii' | 'sensitive';
+interface TelemetryPropertyData {
+  name: string;
+  type: 'string' | 'number' | 'boolean' | 'timestamp' | 'json';
+  required?: boolean;
+  pii?: boolean;
+  redact?: boolean;
+  description?: string;
+}
+interface TelemetryAnomalyRuleData {
+  metric: string;
+  min?: number;
+  max?: number;
+}
+interface TelemetryEventData {
+  name: string;
+  version: number;
+  what: string;
+  who?: string;
+  why?: string;
+  privacy: TelemetryPrivacy;
+  properties: TelemetryPropertyData[];
+  retentionDays?: number;
+  retentionPolicy?: 'archive' | 'delete';
+  samplingRate?: number;
+  samplingConditions?: string;
+  anomalyEnabled?: boolean;
+  anomalyMinimumSample?: number;
+  anomalyRules?: TelemetryAnomalyRuleData[];
+  anomalyActions?: ('alert' | 'log' | 'trigger_regen')[];
+  tags?: string[];
+}
+interface TelemetryProviderData {
+  type: 'posthog' | 'segment' | 'opentelemetry' | 'internal';
+  config: string;
+}
+interface TelemetrySpecData extends BaseSpecData {
+  domain: string;
+  defaultRetentionDays?: number;
+  defaultSamplingRate?: number;
+  providers?: TelemetryProviderData[];
+  anomalyEnabled?: boolean;
+  anomalyCheckIntervalMs?: number;
+  events: TelemetryEventData[];
+}
+interface ExperimentVariantOverrideData {
+  type: 'dataView' | 'workflow' | 'theme' | 'policy' | 'presentation';
+  target: string;
+  version?: number;
+}
+interface ExperimentVariantData {
+  id: string;
+  name: string;
+  description?: string;
+  weight?: number;
+  overrides?: ExperimentVariantOverrideData[];
+}
+interface TargetingRuleData {
+  variantId: string;
+  percentage?: number;
+  policy?: {
+    name: string;
+    version?: number;
+  };
+  expression?: string;
+}
+interface RandomAllocationData {
+  type: 'random';
+  salt?: string;
+}
+interface StickyAllocationData {
+  type: 'sticky';
+  attribute: 'userId' | 'organizationId' | 'sessionId';
+  salt?: string;
+}
+interface TargetedAllocationData {
+  type: 'targeted';
+  fallback?: 'control' | 'random';
+  rules: TargetingRuleData[];
+}
+type ExperimentAllocationData = RandomAllocationData | StickyAllocationData | TargetedAllocationData;
+interface ExperimentMetricData {
+  name: string;
+  eventName: string;
+  eventVersion: number;
+  aggregation: 'count' | 'avg' | 'p75' | 'p90' | 'p95' | 'p99';
+  target?: number;
+}
+interface ExperimentSpecData extends BaseSpecData {
+  domain: string;
+  controlVariant: string;
+  variants: ExperimentVariantData[];
+  allocation: ExperimentAllocationData;
+  successMetrics?: ExperimentMetricData[];
+}
+interface AppConfigMappingData {
+  slot: string;
+  name: string;
+  version?: number;
+}
+interface AppConfigFeatureFlagData {
+  key: string;
+  enabled: boolean;
+  variant?: string;
+  description?: string;
+}
+interface AppRouteConfigData {
+  path: string;
+  label?: string;
+  dataView?: string;
+  workflow?: string;
+  guardName?: string;
+  guardVersion?: number;
+  featureFlag?: string;
+  experimentName?: string;
+  experimentVersion?: number;
+}
+interface AppBlueprintSpecData extends BaseSpecData {
+  title: string;
+  domain: string;
+  appId: string;
+  capabilitiesEnabled: string[];
+  capabilitiesDisabled: string[];
+  featureIncludes: string[];
+  featureExcludes: string[];
+  dataViews: AppConfigMappingData[];
+  workflows: AppConfigMappingData[];
+  policyRefs: {
+    name: string;
+    version?: number;
+  }[];
+  theme?: {
+    name: string;
+    version: number;
+  };
+  themeFallbacks: {
+    name: string;
+    version: number;
+  }[];
+  telemetry?: {
+    name: string;
+    version?: number;
+  };
+  activeExperiments: {
+    name: string;
+    version?: number;
+  }[];
+  pausedExperiments: {
+    name: string;
+    version?: number;
+  }[];
+  featureFlags: AppConfigFeatureFlagData[];
+  routes: AppRouteConfigData[];
+  notes?: string;
+}
+type MigrationStepKind = 'schema' | 'data' | 'validation';
+interface MigrationStepData {
+  kind: MigrationStepKind;
+  description?: string;
+  sql?: string;
+  script?: string;
+  assertion?: string;
+  timeoutMs?: number;
+  retries?: number;
+  preChecks?: {
+    description: string;
+    expression: string;
+  }[];
+  postChecks?: {
+    description: string;
+    expression: string;
+  }[];
+}
+interface MigrationSpecData extends BaseSpecData {
+  title: string;
+  domain: string;
+  dependencies: string[];
+  up: MigrationStepData[];
+  down?: MigrationStepData[];
+}
+type IntegrationCategoryData = 'payments' | 'email' | 'calendar' | 'sms' | 'ai-llm' | 'ai-voice' | 'speech-to-text' | 'vector-db' | 'storage' | 'accounting' | 'crm' | 'helpdesk' | 'open-banking' | 'custom';
+type IntegrationConfigFieldType = 'string' | 'number' | 'boolean';
+type IntegrationOwnershipModeData = 'managed' | 'byok';
+type IntegrationHealthCheckMethod = 'ping' | 'list' | 'custom';
+interface IntegrationCapabilityRefData {
+  key: string;
+  version: number;
+}
+interface IntegrationCapabilityRequirementData {
+  key: string;
+  version?: number;
+  optional?: boolean;
+  reason?: string;
+}
+interface IntegrationConfigFieldData {
+  key: string;
+  type: IntegrationConfigFieldType;
+  required: boolean;
+  description?: string;
+}
+type IntegrationSecretFieldData = IntegrationConfigFieldData;
+interface IntegrationSpecData extends BaseSpecData {
+  title: string;
+  domain: string;
+  displayName: string;
+  category: IntegrationCategoryData;
+  supportedModes: IntegrationOwnershipModeData[];
+  capabilitiesProvided: IntegrationCapabilityRefData[];
+  capabilitiesRequired: IntegrationCapabilityRequirementData[];
+  configFields: IntegrationConfigFieldData[];
+  secretFields: IntegrationSecretFieldData[];
+  docsUrl?: string;
+  rateLimitRpm?: number;
+  rateLimitRph?: number;
+  healthCheckMethod: IntegrationHealthCheckMethod;
+  healthCheckTimeoutMs?: number;
+  byokSetupInstructions?: string;
+  byokRequiredScopes?: string[];
+}
+type KnowledgeCategoryData = 'canonical' | 'operational' | 'external' | 'ephemeral';
+type KnowledgeTrustLevel = 'high' | 'medium' | 'low';
+interface KnowledgeRetentionData {
+  ttlDays?: number | null;
+  archiveAfterDays?: number;
+}
+interface KnowledgeSpaceSpecData extends BaseSpecData {
+  title: string;
+  domain: string;
+  displayName: string;
+  category: KnowledgeCategoryData;
+  retention: KnowledgeRetentionData;
+  policyName?: string;
+  policyVersion?: number;
+  trustLevel: KnowledgeTrustLevel;
+  automationWritable: boolean;
+  embeddingModel?: string;
+  chunkSize?: number;
+  vectorDbIntegration?: string;
+}
+//#endregion
+export { AppBlueprintSpecData, AppConfigFeatureFlagData, AppConfigMappingData, AppRouteConfigData, BaseSpecData, DataViewFieldData, DataViewKind, DataViewSpecData, EventSpecData, ExperimentAllocationData, ExperimentMetricData, ExperimentSpecData, ExperimentVariantData, ExperimentVariantOverrideData, FeatureSpecData, FormSpecData, IntegrationCapabilityRefData, IntegrationCapabilityRequirementData, IntegrationCategoryData, IntegrationConfigFieldData, IntegrationConfigFieldType, IntegrationHealthCheckMethod, IntegrationOwnershipModeData, IntegrationSecretFieldData, IntegrationSpecData, KnowledgeCategoryData, KnowledgeRetentionData, KnowledgeSpaceSpecData, KnowledgeTrustLevel, MigrationSpecData, MigrationStepData, MigrationStepKind, OpKind, OperationSpecData, PresentationKind, PresentationSpecData, RandomAllocationData, SpecType, Stability, StepType, StickyAllocationData, TargetedAllocationData, TargetingRuleData, TelemetryAnomalyRuleData, TelemetryEventData, TelemetryPrivacy, TelemetryPropertyData, TelemetryProviderData, TelemetrySpecData, WorkflowSpecData, WorkflowStepData, WorkflowTransitionData };
+//# sourceMappingURL=spec-types.d.ts.map

package/dist/types/spec-types.d.ts.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@contractspec/module.workspace",
+  "version": "1.44.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun run"
+  },
+  "dependencies": {
+    "@contractspec/lib.contracts": "1.44.0",
+    "@contractspec/lib.schema": "1.44.0",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/modules/contractspec-workspace"
+  },
+  "homepage": "https://contractspec.io"
+}