skedyul 1.6.0 → 1.7.1

package/dist/index.js

@@ -82,6 +82,9 @@ __export(index_exports, {
   DatePickerComponentDefinitionSchema: () => DatePickerComponentDefinitionSchema,
   DayOfWeekSchema: () => DayOfWeekSchema,
   EmptyFormComponentDefinitionSchema: () => EmptyFormComponentDefinitionSchema,
+  EntityDefinitionSchema: () => EntityDefinitionSchema,
+  EntityFieldDefinitionSchema: () => EntityFieldDefinitionSchema,
+  EntityRelationshipDefinitionSchema: () => EntityRelationshipDefinitionSchema,
   EnvSchemaSchema: () => EnvSchemaSchema,
   EnvVariableDefinitionSchema: () => EnvVariableDefinitionSchema,
   EnvVisibilitySchema: () => EnvVisibilitySchema,
@@ -152,7 +155,6 @@ __export(index_exports, {
   ModelDefinitionSchema: () => ModelDefinitionSchema,
   ModelDependencySchema: () => ModelDependencySchema,
   ModelFieldDefinitionSchema: () => ModelFieldDefinitionSchema,
-  ModelMapperBlockDefinitionSchema: () => ModelMapperBlockDefinitionSchema,
   MoneyMinorRangeSchema: () => MoneyMinorRangeSchema,
   NavigationBreadcrumbSchema: () => NavigationBreadcrumbSchema,
   NavigationConfigSchema: () => NavigationConfigSchema,
@@ -203,6 +205,8 @@ __export(index_exports, {
   SequencerContextError: () => SequencerContextError,
   SequencerLockError: () => SequencerLockError,
   SequencerNotFoundError: () => SequencerNotFoundError,
+  SetupStepDefinitionSchema: () => SetupStepDefinitionSchema,
+  SetupStepKindSchema: () => SetupStepKindSchema,
   SkedyulConfigSchema: () => SkedyulConfigSchema,
   SkillExampleSchema: () => SkillExampleSchema,
   SkillMetadataSchema: () => SkillMetadataSchema,
@@ -292,11 +296,13 @@ __export(index_exports, {
   defineAgent: () => defineAgent,
   defineChannel: () => defineChannel,
   defineConfig: () => defineConfig,
+  defineEntity: () => defineEntity,
   defineEnv: () => defineEnv,
   defineModel: () => defineModel,
   defineNavigation: () => defineNavigation,
   definePage: () => definePage,
   defineSchema: () => defineSchema,
+  defineSetupStep: () => defineSetupStep,
   defineSkill: () => defineSkill,
   defineWorkflow: () => defineWorkflow,
   defineWorkflowYAML: () => defineWorkflowYAML,
@@ -358,6 +364,7 @@ __export(index_exports, {
   sequencerAllow: () => allow,
   sequencerRelease: () => release,
   server: () => server,
+  setup: () => setup,
   toGsm7: () => toGsm7,
   token: () => token,
   validateCRMSchema: () => validateCRMSchema,
@@ -1657,6 +1664,45 @@ var ModelDefinitionSchema = import_v48.z.object({
   page: import_v48.z.string().optional(),
   env: EnvSchemaSchema.optional()
 });
+var EntityFieldDefinitionSchema = import_v48.z.object({
+  handle: import_v48.z.string(),
+  label: import_v48.z.string(),
+  description: import_v48.z.string().optional(),
+  type: import_v48.z.enum([
+    "string",
+    "long_string",
+    "number",
+    "boolean",
+    "date",
+    "datetime",
+    "object"
+  ]).optional(),
+  isUnique: import_v48.z.boolean().optional(),
+  /** @deprecated Prefer isUnique */
+  matchCandidate: import_v48.z.boolean().optional(),
+  required: import_v48.z.boolean().optional(),
+  options: import_v48.z.array(
+    import_v48.z.union([
+      import_v48.z.string(),
+      import_v48.z.object({ value: import_v48.z.string(), label: import_v48.z.string() })
+    ])
+  ).optional()
+});
+var EntityRelationshipDefinitionSchema = import_v48.z.object({
+  handle: import_v48.z.string(),
+  label: import_v48.z.string(),
+  targetEntity: import_v48.z.string().optional(),
+  description: import_v48.z.string().optional()
+});
+var EntityDefinitionSchema = import_v48.z.object({
+  handle: import_v48.z.string(),
+  label: import_v48.z.string(),
+  labelPlural: import_v48.z.string().optional(),
+  description: import_v48.z.string().optional(),
+  fields: import_v48.z.array(EntityFieldDefinitionSchema),
+  contextFields: import_v48.z.array(EntityFieldDefinitionSchema).optional(),
+  relationships: import_v48.z.array(EntityRelationshipDefinitionSchema).optional()
+});
 var RelationshipCardinalitySchema = import_v48.z.enum([
   "ONE_TO_ONE",
   "ONE_TO_MANY"
@@ -2073,16 +2119,10 @@ var ListBlockDefinitionSchema = import_v48.z.object({
   icon: import_v48.z.string().optional(),
   emptyMessage: import_v48.z.string().optional()
 });
-var ModelMapperBlockDefinitionSchema = import_v48.z.object({
-  type: import_v48.z.literal("model_mapper"),
-  /** The SHARED model handle from install config (e.g., "client", "patient") */
-  model: import_v48.z.string()
-});
 var PageBlockDefinitionSchema = import_v48.z.union([
   CardBlockDefinitionSchema,
   LegacyFormBlockDefinitionSchema,
-  ListBlockDefinitionSchema,
-  ModelMapperBlockDefinitionSchema
+  ListBlockDefinitionSchema
 ]);
 var PageContextModeSchema = import_v48.z.enum(["first", "many", "count", "all"]).transform((val) => val === "all" ? "many" : val);
 var PageContextFiltersSchema = import_v48.z.record(
@@ -2221,17 +2261,35 @@ var InstallConfigSchema = import_v48.z.object({
   /** Relationship definitions between SHARED models */
   relationships: import_v48.z.array(RelationshipDefinitionSchema).optional()
 });
+var SetupStepKindSchema = import_v48.z.enum(["app", "crm", "realtime", "env"]);
+var SetupStepDefinitionSchema = import_v48.z.object({
+  handle: import_v48.z.string(),
+  label: import_v48.z.string(),
+  description: import_v48.z.string().optional(),
+  kind: SetupStepKindSchema,
+  requires: import_v48.z.array(import_v48.z.string()).optional(),
+  entities: import_v48.z.array(import_v48.z.string()).optional(),
+  workflowHandles: import_v48.z.array(import_v48.z.string()).optional(),
+  envKeys: import_v48.z.array(import_v48.z.string()).optional(),
+  listenToCrm: import_v48.z.boolean().optional(),
+  listenToEnv: import_v48.z.boolean().optional(),
+  capabilities: import_v48.z.array(import_v48.z.string()).optional()
+});
 var ProvisionConfigSchema = import_v48.z.object({
   env: EnvSchemaSchema.optional(),
   /** INTERNAL model definitions (app-owned, not visible to users) */
   models: import_v48.z.array(ModelDefinitionSchema).optional(),
+  /** App entity contracts for install-time CRM maps (not shared models) */
+  entities: import_v48.z.array(EntityDefinitionSchema).optional(),
   /** Relationship definitions between INTERNAL models */
   relationships: import_v48.z.array(RelationshipDefinitionSchema).optional(),
   channels: import_v48.z.array(ChannelDefinitionSchema).optional(),
   workflows: import_v48.z.array(WorkflowDefinitionSchema).optional(),
   /** Base navigation configuration for all pages (can be overridden per page) */
   navigation: NavigationConfigSchema.optional(),
-  pages: import_v48.z.array(PageDefinitionSchema).optional()
+  pages: import_v48.z.array(PageDefinitionSchema).optional(),
+  /** Install setup checklist steps (opt-in) */
+  setup: import_v48.z.array(SetupStepDefinitionSchema).optional()
 });
 var SkedyulConfigSchema = import_v48.z.object({
   name: import_v48.z.string(),
@@ -3880,6 +3938,47 @@ var report = {
     return data;
   }
 };
+var setup = {
+  async list() {
+    const { data } = await callCore("setup.list", {});
+    return data;
+  },
+  async get(handle) {
+    const { data } = await callCore("setup.get", {
+      handle
+    });
+    return data;
+  },
+  async complete(handle, metadata) {
+    const { data } = await callCore("setup.complete", {
+      handle,
+      ...metadata ? { metadata } : {}
+    });
+    return data;
+  },
+  async skip(handle, metadata) {
+    const { data } = await callCore("setup.skip", {
+      handle,
+      ...metadata ? { metadata } : {}
+    });
+    return data;
+  },
+  async invalidate(handle, reason, metadata) {
+    const { data } = await callCore("setup.invalidate", {
+      handle,
+      ...reason ? { reason } : {},
+      ...metadata ? { metadata } : {}
+    });
+    return data;
+  },
+  async capabilities() {
+    const { data } = await callCore(
+      "setup.capabilities",
+      {}
+    );
+    return data.capabilities;
+  }
+};
 
 // src/ratelimit/context.ts
 var import_async_hooks2 = require("async_hooks");
@@ -4914,6 +5013,72 @@ async function handleProvision(body, hooks) {
   }
 }
 
+// src/server/handlers/setup-revalidate-handler.ts
+async function handleSetupRevalidate(body, hooks) {
+  const revalidateHook = hooks?.setup?.revalidate;
+  if (!revalidateHook) {
+    return {
+      status: 404,
+      body: { error: "Setup revalidate handler not configured" }
+    };
+  }
+  if (!body.context?.appInstallationId || !body.context?.workplace || !body.context?.app || !body.reason || !Array.isArray(body.steps)) {
+    return {
+      status: 400,
+      body: {
+        error: {
+          code: -32602,
+          message: "Missing context (appInstallationId, workplace, app, reason, and steps required)"
+        }
+      }
+    };
+  }
+  const ctx = {
+    env: body.env ?? {},
+    workplace: body.context.workplace,
+    appInstallationId: body.context.appInstallationId,
+    app: body.context.app,
+    reason: body.reason,
+    steps: body.steps,
+    crm: body.crm,
+    envChange: body.envChange,
+    invocation: body.invocation,
+    log: createContextLogger()
+  };
+  const requestConfig = {
+    baseUrl: body.env?.SKEDYUL_API_URL ?? process.env.SKEDYUL_API_URL ?? "",
+    apiToken: body.env?.SKEDYUL_API_TOKEN ?? process.env.SKEDYUL_API_TOKEN ?? ""
+  };
+  try {
+    const handler = typeof revalidateHook === "function" ? revalidateHook : revalidateHook.handler;
+    const result = await runWithLogContext(
+      { invocation: body.invocation },
+      async () => {
+        return await runWithConfig(requestConfig, async () => {
+          return await handler(ctx);
+        });
+      }
+    );
+    return {
+      status: 200,
+      body: {
+        completed: result?.completed ?? [],
+        invalidated: result?.invalidated ?? []
+      }
+    };
+  } catch (err) {
+    return {
+      status: 500,
+      body: {
+        error: {
+          code: -32603,
+          message: err instanceof Error ? err.message : String(err ?? "")
+        }
+      }
+    };
+  }
+}
+
 // src/server/handler-helpers.ts
 function parseHandlerEnvelope(parsedBody) {
   if (typeof parsedBody !== "object" || parsedBody === null || Array.isArray(parsedBody) || !("env" in parsedBody) || !("request" in parsedBody)) {
@@ -5300,6 +5465,14 @@ async function handleProvisionRoute(req, ctx) {
   const result = await handleProvision(parseResult.data, ctx.config.hooks);
   return { status: result.status, body: result.body };
 }
+async function handleSetupRevalidateRoute(req, ctx) {
+  const parseResult = parseJsonBody(req);
+  if (!parseResult.success) {
+    return parseResult.error;
+  }
+  const result = await handleSetupRevalidate(parseResult.data, ctx.config.hooks);
+  return { status: result.status, body: result.body };
+}
 async function handleOAuthCallbackRoute(req, ctx) {
   const parseResult = parseJsonBody(req);
   if (!parseResult.success) {
@@ -5661,6 +5834,9 @@ async function routeRequest(req, ctx) {
     if (req.path === "/provision" && req.method === "POST") {
       return handleProvisionRoute(req, ctx);
     }
+    if (req.path === "/setup/revalidate" && req.method === "POST") {
+      return handleSetupRevalidateRoute(req, ctx);
+    }
     if (req.path === "/oauth_callback" && req.method === "POST") {
       return handleOAuthCallbackRoute(req, ctx);
     }
@@ -6115,6 +6291,9 @@ function defineConfig(config) {
 function defineModel(model) {
   return model;
 }
+function defineEntity(entity) {
+  return entity;
+}
 function defineChannel(channel) {
   return channel;
 }
@@ -6133,6 +6312,9 @@ function defineEnv(env) {
 function defineNavigation(navigation) {
   return navigation;
 }
+function defineSetupStep(step) {
+  return step;
+}
 
 // src/config/schema-loader.ts
 var fs4 = __toESM(require("fs"));
@@ -8598,6 +8780,9 @@ var index_default = { z: import_v414.z };
   DatePickerComponentDefinitionSchema,
   DayOfWeekSchema,
   EmptyFormComponentDefinitionSchema,
+  EntityDefinitionSchema,
+  EntityFieldDefinitionSchema,
+  EntityRelationshipDefinitionSchema,
   EnvSchemaSchema,
   EnvVariableDefinitionSchema,
   EnvVisibilitySchema,
@@ -8668,7 +8853,6 @@ var index_default = { z: import_v414.z };
   ModelDefinitionSchema,
   ModelDependencySchema,
   ModelFieldDefinitionSchema,
-  ModelMapperBlockDefinitionSchema,
   MoneyMinorRangeSchema,
   NavigationBreadcrumbSchema,
   NavigationConfigSchema,
@@ -8719,6 +8903,8 @@ var index_default = { z: import_v414.z };
   SequencerContextError,
   SequencerLockError,
   SequencerNotFoundError,
+  SetupStepDefinitionSchema,
+  SetupStepKindSchema,
   SkedyulConfigSchema,
   SkillExampleSchema,
   SkillMetadataSchema,
@@ -8807,11 +8993,13 @@ var index_default = { z: import_v414.z };
   defineAgent,
   defineChannel,
   defineConfig,
+  defineEntity,
   defineEnv,
   defineModel,
   defineNavigation,
   definePage,
   defineSchema,
+  defineSetupStep,
   defineSkill,
   defineWorkflow,
   defineWorkflowYAML,
@@ -8873,6 +9061,7 @@ var index_default = { z: import_v414.z };
   sequencerAllow,
   sequencerRelease,
   server,
+  setup,
   toGsm7,
   token,
   validateCRMSchema,