@relyio/cli 0.14.0 → 0.15.0

package/dist/index.js

@@ -19960,7 +19960,7 @@ var init_chunk_NJQK5STK = __esm({
   }
 });
 
-// ../sdk/dist/chunk-W2A4OTCI.js
+// ../sdk/dist/chunk-EQUZNVAR.js
 function readDeadline(raw, now) {
   if (raw === void 0 || raw === null || raw === "") return { state: "none" };
   if (typeof raw !== "string") return { state: "unreadable" };
@@ -20022,8 +20022,8 @@ function parseDevEnv(env, now) {
   }
 }
 var DEV_CONTEXT_DIR, DEV_CONTEXT_FILENAME, DEV_CONTEXT_FILE, DEV_ENV;
-var init_chunk_W2A4OTCI = __esm({
-  "../sdk/dist/chunk-W2A4OTCI.js"() {
+var init_chunk_EQUZNVAR = __esm({
+  "../sdk/dist/chunk-EQUZNVAR.js"() {
     init_chunk_DI6KFDBO();
     DEV_CONTEXT_DIR = ".relyio";
     DEV_CONTEXT_FILENAME = "dev.json";
@@ -20075,7 +20075,7 @@ var init_chunk_HDHBYYEY = __esm({
   }
 });
 
-// ../sdk/dist/chunk-T7LGREB3.js
+// ../sdk/dist/chunk-OUR7OUUZ.js
 function defineRoute(route) {
   if (route.kind === "raw" && route.standardShape === void 0) {
     throw new Error("kind 'raw' requires a named StandardShape");
@@ -20264,8 +20264,8 @@ function contributedFieldKindName(extension, kind) {
   return `${extension}.${kind}`;
 }
 var HEADER_END_USER, END_USER_TOKEN_REFUSAL_REASONS, HEADER_RETRY_AFTER, HEADER_IF_MATCH, HEADER_IDEMPOTENCY_KEY, FRESH_PARAMETER, K, rotr, PREVIEW_DATASET_PREFIX, READABLE_MAX, HASH_DIGITS, VISITOR_LIVE_PATH, VISITOR_QUERY, VISITOR_CURSOR, VISITOR_POLL_INTERVAL_MS, VISITOR_KEEPALIVE, VISITOR_FRAMES, VISITOR_CLOSE_CODES, VISITOR_CLOSE_RETRY, VISITOR_POLL_RETRY, VISITOR_ADMISSION_RETRY_AFTER_SECONDS, CHANGE_KINDS, RESYNC_REASONS, FUNCTION_RUN_FAILURES, WEBHOOK_EVENT_ID_HEADER, RESEND_IDEMPOTENCY_HEADER, RESEND_ATTACHMENTS_MAX_BYTES, DEPLOYMENT_SUCCEEDED, STRIPE_EVENT_FIELDS, STRIPE_SUBSCRIPTION_FIELDS, IDENTITY_CLAIMS_SETTING, IDENTITY_CLAIMS_SETTING_FIELD, EXTENSION_SURFACES, CONTRIBUTED_FIELD_KIND_OPTION, EXTENSION_BACKFILL_REFUSALS;
-var init_chunk_T7LGREB3 = __esm({
-  "../sdk/dist/chunk-T7LGREB3.js"() {
+var init_chunk_OUR7OUUZ = __esm({
+  "../sdk/dist/chunk-OUR7OUUZ.js"() {
     init_chunk_DI6KFDBO();
     __name(defineRoute, "defineRoute");
     __name(refuseMismatchedAlternate, "refuseMismatchedAlternate");
@@ -20918,7 +20918,7 @@ var init_chunk_T7LGREB3 = __esm({
   }
 });
 
-// ../sdk/dist/chunk-356SF5Y2.js
+// ../sdk/dist/chunk-L42C4G2S.js
 function isResourceNotFound(error2) {
   return error2 instanceof ResourceNotFoundError;
 }
@@ -21342,15 +21342,25 @@ function readHeaders(options) {
   if (options.fresh === true) headers["Cache-Control"] = "no-cache";
   return Object.keys(headers).length > 0 ? headers : void 0;
 }
+function mimeMatches(fileType, pattern) {
+  const actual = (fileType.split(";")[0] ?? "").trim().toLowerCase();
+  const allowed = (pattern.split(";")[0] ?? "").trim().toLowerCase();
+  if (allowed === "*" || allowed === "*/*") return true;
+  if (allowed === actual) return true;
+  const [allowedType, allowedSubtype] = allowed.split("/");
+  const [actualType] = actual.split("/");
+  return allowedSubtype === "*" && allowedType === actualType;
+}
 function validateFile(file2, constraints = {}) {
   const violations = [];
   const { allowedMimeTypes, maxSizeBytes } = constraints;
-  if (allowedMimeTypes && allowedMimeTypes.length > 0 && file2.type != null && file2.type !== "" && !allowedMimeTypes.includes(file2.type)) {
+  const { type } = file2;
+  if (allowedMimeTypes && allowedMimeTypes.length > 0 && type != null && type !== "" && !allowedMimeTypes.some((pattern) => mimeMatches(type, pattern))) {
     violations.push({
       field: "file",
       code: "UNSUPPORTED_MIME",
-      message: `Unsupported file type "${file2.type}". Allowed: ${allowedMimeTypes.join(", ")}`,
-      value: file2.type
+      message: `Unsupported file type "${type}". Allowed: ${allowedMimeTypes.join(", ")}`,
+      value: type
     });
   }
   if (typeof maxSizeBytes === "number" && maxSizeBytes > 0 && typeof file2.size === "number" && file2.size > maxSizeBytes) {
@@ -22406,12 +22416,12 @@ function randomClientId() {
   return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 }
 var PUBLISHABLE_KEY_PREFIX, isPublishableKey, PREVIEW_KEY_PREFIX, isPreviewKey, _SDKError, SDKError, _ResourceNotFoundError, ResourceNotFoundError, _ResourceConflictError, ResourceConflictError, _ResourceExpiredError, ResourceExpiredError, _MissingApiKeyError, MissingApiKeyError, _ReadOnlyKeyError, ReadOnlyKeyError, _PublishableKeyRefusedError, PublishableKeyRefusedError, _FunctionRunFailedError, FunctionRunFailedError, _FunctionContainersBusyError, FunctionContainersBusyError, _FunctionRunTimedOutError, FunctionRunTimedOutError, _PlanFeatureUnavailableError, PlanFeatureUnavailableError, _UsageQuotaExceededError, UsageQuotaExceededError, _RateLimitError, RateLimitError, _MethodNotAllowedError, MethodNotAllowedError, _PayloadTooLargeError, PayloadTooLargeError, _TransactionRolledBackError, TransactionRolledBackError, _ServiceIndeterminateError, ServiceIndeterminateError, _ServerError, ServerError, _UnknownContractError, UnknownContractError, _AuthorizationError, AuthorizationError, _InvalidApiKeyError, InvalidApiKeyError, _EndUserTokenInvalidError, EndUserTokenInvalidError, _NetworkError, NetworkError, _TimeoutError, TimeoutError, _ConnectionError, ConnectionError, _BaseValidationError, BaseValidationError, _ValidationError, ValidationError, _InvalidPayloadError, InvalidPayloadError, _a50, ContractBodyError, STALE_VERSION_GUIDANCE, _ErrorMapper, ErrorMapper, DECLARED_PATHS, COMPILED_ROUTES, IDEMPOTENT_METHODS, UNREACHABLE_CODES, _DefaultRetryPolicy, DefaultRetryPolicy, derived, unknown, announced, MAX_TIMER_DELAY_MS, _HttpClient, HttpClient, _ControlledHttpClient, ControlledHttpClient, API_KEY_HEADER, DATASET_HEADER, END_USER_HEADER, BROWSER_CONTROLLED_HEADERS, _EntryHandle, EntryHandle, _ContentClient, ContentClient, _FileUploadError, FileUploadError, _FileValidationError, FileValidationError, FILE_ERROR_CODES, _AssetFileBuilder, AssetFileBuilder, _AssetUploadBuilder, AssetUploadBuilder, _AssetClient, AssetClient, _DocumentHandle, DocumentHandle, _SingletonClient, SingletonClient, _SettingsClient, SettingsClient, _RecordsClient, RecordsClient, OPERATION_PATH, CHANGES_POLL_TIMEOUT_MS, EXPIRED_REASONS2, _ChangesExpiredError, ChangesExpiredError, _LiveEdgeError, LiveEdgeError, LIVE_EDGE_OF_API, HTTP_SCHEME_OF, LIVE_KEEPALIVE_INTERVAL_MS, LIVE_SOCKET_OPEN_TIMEOUT_MS, LIVE_POLLS_BEFORE_SOCKET, SOCKET_CONNECTING, SOCKET_OPEN, AFTER_A_CLOSE, CLOSE_MEANING, NEEDS_PUBLISHABLE_KEY, FUNCTION_CALL_TIMEOUT_MS, VERBS, DEFAULT_CONFIG, devOverrideNotified, previewNotified, _TypedRelyIOClient, TypedRelyIOClient;
-var init_chunk_356SF5Y2 = __esm({
-  "../sdk/dist/chunk-356SF5Y2.js"() {
+var init_chunk_L42C4G2S = __esm({
+  "../sdk/dist/chunk-L42C4G2S.js"() {
     init_chunk_NJQK5STK();
-    init_chunk_W2A4OTCI();
+    init_chunk_EQUZNVAR();
     init_chunk_HDHBYYEY();
-    init_chunk_T7LGREB3();
+    init_chunk_OUR7OUUZ();
     init_chunk_DI6KFDBO();
     PUBLISHABLE_KEY_PREFIX = "rly_pub_";
     isPublishableKey = /* @__PURE__ */ __name((apiKey) => apiKey?.startsWith(PUBLISHABLE_KEY_PREFIX) === true, "isPublishableKey");
@@ -23935,6 +23945,7 @@ var init_chunk_356SF5Y2 = __esm({
     };
     __name(_ContentClient, "ContentClient");
     ContentClient = _ContentClient;
+    __name(mimeMatches, "mimeMatches");
     _FileUploadError = class _FileUploadError2 extends SDKError {
       constructor(code19, message, options = {}) {
         super(message, options.statusCode, options.cause, { ...options.context, fileErrorCode: code19 });
@@ -25827,9 +25838,9 @@ function snapToLadder(value) {
 var FOLLOW_RETRY_BASE_MS, FOLLOW_RETRY_MAX_MS, FOLLOW_BACK_OFF_MAX_MS, LOCALE_STATUS_PUBLISHED, IMAGE_LADDER;
 var init_dist2 = __esm({
   "../sdk/dist/index.js"() {
-    init_chunk_356SF5Y2();
-    init_chunk_356SF5Y2();
-    init_chunk_T7LGREB3();
+    init_chunk_L42C4G2S();
+    init_chunk_L42C4G2S();
+    init_chunk_OUR7OUUZ();
     init_chunk_DI6KFDBO();
     FOLLOW_RETRY_BASE_MS = 1e3;
     FOLLOW_RETRY_MAX_MS = 3e4;
@@ -25862,9 +25873,9 @@ var init_dist2 = __esm({
   }
 });
 
-// ../../platform/api-contract/dist/chunk-WT7DXIEW.js
-var init_chunk_WT7DXIEW = __esm({
-  "../../platform/api-contract/dist/chunk-WT7DXIEW.js"() {
+// ../../platform/api-contract/dist/chunk-4KRF3DVJ.js
+var init_chunk_4KRF3DVJ = __esm({
+  "../../platform/api-contract/dist/chunk-4KRF3DVJ.js"() {
   }
 });
 
@@ -26254,7 +26265,7 @@ function readError2(body) {
 var ContractBodyError2;
 var init_client = __esm({
   "../../platform/api-contract/dist/client/index.js"() {
-    init_chunk_WT7DXIEW();
+    init_chunk_4KRF3DVJ();
     init_chunk_VFXRYMMX();
     ContractBodyError2 = class extends Error {
       body;
@@ -41912,7 +41923,7 @@ var init_dist3 = __esm({
     init_chunk_6JGYNMIT();
     init_chunk_OWKTFXBY();
     init_chunk_J2UAM3VR();
-    init_chunk_WT7DXIEW();
+    init_chunk_4KRF3DVJ();
     init_chunk_VFXRYMMX();
     init_chunk_46347LG2();
     HEADER_RETRY_AFTER2 = { name: "Retry-After" };
@@ -41940,6 +41951,12 @@ var init_dist3 = __esm({
       "output-invalid"
     ];
     new Set(FUNCTION_RUN_FAILURES2);
+    [
+      "running",
+      "succeeded",
+      ...FUNCTION_RUN_FAILURES2,
+      "lost"
+    ];
     GITHUB_INSTALLATION_EVENTS = ["installation", "installation_repositories"];
     GITHUB_REPOSITORY_EVENTS = [
       "push",
@@ -52302,7 +52319,7 @@ var init_extensions = __esm({
   "../sdk/dist/extensions/index.js"() {
     init_chunk_W2GRVXDG();
     init_chunk_PZCDJFMA();
-    init_chunk_T7LGREB3();
+    init_chunk_OUR7OUUZ();
     init_chunk_DI6KFDBO();
     DECLARED = "declared";
     SURFACES = EXTENSION_SURFACES;
@@ -52360,13 +52377,6 @@ async function getSchemaStatus(projectId, branchId, localSchema) {
     )
   );
 }
-async function getCurrentSchema(projectId, branchId) {
-  return readPayload2(
-    await client_default.get(
-      `/projects/${projectId}/branches/${branchId}/schema`
-    )
-  );
-}
 async function getAdaptationStatus(projectId, branchId) {
   return readPayload2(
     await client_default.get(
@@ -52374,16 +52384,10 @@ async function getAdaptationStatus(projectId, branchId) {
     )
   );
 }
-var schema_default;
 var init_schema = __esm({
   "src/api/schema.ts"() {
     init_client2();
     init_wire();
-    schema_default = {
-      getSchemaStatus,
-      getCurrentSchema,
-      getAdaptationStatus
-    };
   }
 });
 
@@ -52539,31 +52543,46 @@ async function declarationOf(absolute) {
   }
   return { declaration: definition.declaration };
 }
-async function loadFunctions(projectRoot) {
-  const functions = [];
+async function readFunctionFiles(projectRoot, then) {
+  const read = [];
   const errors = [];
   for (const file2 of functionFiles(projectRoot)) {
     const item = itemAt(file2);
     if (item === void 0) continue;
     try {
-      const read = await declarationOf(path7.join(projectRoot, file2));
-      if ("error" in read) {
-        errors.push({ file: file2, error: read.error });
+      const declared = await declarationOf(path7.join(projectRoot, file2));
+      if ("error" in declared) {
+        errors.push({ file: file2, error: declared.error });
         continue;
       }
-      const bundle = await bundleOf(projectRoot, file2, read.declaration.runtime);
-      functions.push({
-        name: item.name,
-        file: file2,
-        declaration: read.declaration,
-        bundle,
-        bundleHash: bundleHashOf(bundle)
-      });
+      read.push(await then({ name: item.name, file: file2, declaration: declared.declaration }));
     } catch (error2) {
       errors.push({ file: file2, error: error2 instanceof Error ? error2.message : String(error2) });
     }
   }
-  return { functions, errors };
+  return { read, errors };
+}
+async function loadFunctions(projectRoot) {
+  const { read, errors } = await readFunctionFiles(projectRoot, async (declared) => {
+    const bundle = await bundleOf(projectRoot, declared.file, declared.declaration.runtime);
+    return { ...declared, bundle, bundleHash: bundleHashOf(bundle) };
+  });
+  return { functions: read, errors };
+}
+async function loadFunctionDeclarations(projectRoot) {
+  const { read, errors } = await readFunctionFiles(projectRoot, async (declared) => declared);
+  return { functions: read, errors };
+}
+function functionsIrOf(declared) {
+  return Object.fromEntries(
+    declared.map(({ name, declaration }) => [
+      name,
+      {
+        input: declaration.input,
+        ...declaration.output === void 0 ? {} : { output: declaration.output }
+      }
+    ])
+  );
 }
 var CONTAINER_REQUIRE_BANNER;
 var init_functions_loader = __esm({
@@ -53125,12 +53144,8 @@ async function run(options) {
   const manifest = await readManifest(options.projectRoot);
   if ("code" in manifest) return failed(manifest);
   try {
-    return {
-      status: "ok",
-      branchName,
-      branchId,
-      plan: await planManifest(projectId, branchId, manifest)
-    };
+    const { deploy, ...plan } = await planManifest(projectId, branchId, manifest);
+    return { status: "ok", branchName, branchId, plan, deploy };
   } catch (error2) {
     return failed(apiError(error2));
   }
@@ -53449,7 +53464,7 @@ var init_deploy_service = __esm({
 // ../sdk/dist/dev-handshake/index.js
 var init_dev_handshake = __esm({
   "../sdk/dist/dev-handshake/index.js"() {
-    init_chunk_W2A4OTCI();
+    init_chunk_EQUZNVAR();
   }
 });
 function planPathLabel(path32) {
@@ -53623,6 +53638,25 @@ function formatManifestPlan(plan) {
   );
   return lines.join("\n");
 }
+function formatDeployNote(deploy) {
+  switch (deploy.outcome) {
+    case "allowed": {
+      return chalk12.gray(`Deploying it from here: ${deploy.note}`);
+    }
+    case "refused": {
+      return chalk12.yellow(`Deploying it from here would be refused: ${deploy.note}`);
+    }
+    case "indeterminate": {
+      return chalk12.yellow(
+        `Whether deploying it from here would be refused is unknown: ${deploy.note}`
+      );
+    }
+    default: {
+      const unhandled = deploy;
+      throw new Error(`Unhandled deploy note ${JSON.stringify(unhandled)}`);
+    }
+  }
+}
 function confirmationLine(plan) {
   if (!plan.needsConfirmation) return "Nothing deletes or rewrites data.";
   const count3 = plan.areas.flatMap((area) => area.lines).filter((line) => line.deletesOrRewritesData).length;
@@ -53748,7 +53782,7 @@ var init_dist6 = __esm({
   }
 });
 
-// ../codegen-typescript/dist/chunk-57IQB4TX.js
+// ../codegen-typescript/dist/chunk-TPUN4ZUQ.js
 function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -53812,12 +53846,12 @@ function policyReference(test, literal4) {
   );
   return plain ? `conditionRoot(${literal4(test.root)})${test.path.map((segment) => `.${segment}`).join("")}` : `conditionRoot(${literal4(test.root)}, ${literal4(test.path)})`;
 }
-async function generateTypeScript(rawSchema, options = {}, format2) {
+async function generateTypeScript(rawSchema, options, format2) {
   const generator = new TypeScriptGenerator(parseSchema(rawSchema), options, format2);
   const content = await generator.generate();
   return { content, warnings: generator.warnings };
 }
-async function generateTypeScriptFromSchema(rawSchema, options = {}, format2) {
+async function generateTypeScriptFromSchema(rawSchema, options, format2) {
   const parsedSchema = parseSchema(rawSchema);
   const generator = new TypeScriptGenerator(parsedSchema, options, format2);
   return generator.generate();
@@ -53877,8 +53911,8 @@ function collectFieldsets(elements) {
   return collected;
 }
 var SchemaParser, SchemaValidator2, TEST_NAMES3, FLAG_TESTS, BARE_TESTS, EXTENSIONS_IMPORT, IDENTITY_KEYS, KEYED_FIELD_OPTIONS2, CONFIG_WRITTEN_AS, TypeScriptGenerator, SCHEMA_PRINT_OPTIONS;
-var init_chunk_57IQB4TX = __esm({
-  "../codegen-typescript/dist/chunk-57IQB4TX.js"() {
+var init_chunk_TPUN4ZUQ = __esm({
+  "../codegen-typescript/dist/chunk-TPUN4ZUQ.js"() {
     init_dist4();
     init_dist6();
     init_dist4();
@@ -54312,6 +54346,8 @@ ${prefix}: ${error2.path}`, `   ${error2.message}`);
         this.addQueries();
         this.addSchemaExport();
         this.addTypeExports();
+        const functions = this.addFunctions();
+        this.addRegisterAugmentation(functions);
         this.addImports(importsAt);
         this.assertNoNameIsDeclaredTwice();
         this.warnings = this.differences();
@@ -54477,7 +54513,13 @@ import type {} from '@relyio/sdk'
           ...[...this.schema.assetTypes.values()].map((element) => element.source),
           ...[...this.schema.singletons.values()].map((element) => element.source),
           ...[...this.schema.settingsGroups.values()].map((element) => element.source),
-          ...[...this.schema.recordTypes.values()].map((element) => element.source)
+          ...[...this.schema.recordTypes.values()].map((element) => element.source),
+          // A Function's input and output place fieldsets as an element's fields do (REL-4059): one
+          // const per id across the whole file
+          ...this.functionsInOrder().flatMap(([, fn]) => [
+            { fields: [...fn.input] },
+            ...fn.output === void 0 ? [] : [{ fields: [...fn.output] }]
+          ])
         ]);
         if (this.fieldsets.size === 0) return;
         this.output.push(`// ============================================================================
@@ -55287,11 +55329,56 @@ export type ${this.declare("SchemaTypes", "type", "the SchemaTypes export")} = t
           );
         }
         this.output.push(lines.join("\n"), "");
-        this.addRegisterAugmentation();
+      }
+      /**
+       * The project's Functions in name order (REL-4059), sorted so the same Functions write the same
+       * bytes, which `relyio ci` compares.
+       */
+      functionsInOrder() {
+        return Object.entries(this.options.functions).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+      }
+      /**
+       * Each Function's Fields as a const (REL-4059): its input — and its output, when it declares one —
+       * as the keyed record its file declares, `{ cartId: fields.shortText({ required: true }) }`,
+       * written by the field emitter every schema element's fields are. {@link addRegisterAugmentation}
+       * registers each under the Function's name, so `relyio.functions.<name>(input)` takes and answers
+       * what they declare. Answers each name beside its const; none when the project declares none.
+       */
+      addFunctions() {
+        const functions = this.functionsInOrder();
+        if (functions.length === 0) return [];
+        this.output.push(`// ============================================================================
+// \u26A1 Functions (what \`relyio.functions.<name>(input)\` takes and answers)
+// ============================================================================
+`);
+        return functions.map(([name, fn]) => {
+          const source = `Function '${name}'`;
+          const varName = this.declare(`${naming.camel(name)}Function`, "value", source);
+          if (!/^[A-Za-z_$][\w$]*$/.test(varName)) {
+            throw new Error(
+              `${source} has no name a TypeScript const can be derived from: a Function's name is a letter, then letters, digits, '_' or '-'`
+            );
+          }
+          const entries2 = [`input: ${this.fieldRecord([...fn.input], `${source}'s input`)}`];
+          if (fn.output !== void 0) {
+            entries2.push(`output: ${this.fieldRecord([...fn.output], `${source}'s output`)}`);
+          }
+          this.output.push(
+            [
+              `/** The Fields of the Function \`${name}\`, as \`relyio/functions/${name}.ts\` declares them */`,
+              `const ${varName} = { ${entries2.join(", ")} }`
+            ].join("\n"),
+            ""
+          );
+          return { name, varName };
+        });
       }
       /**
        * Register this schema with the SDK, so `createClient({ apiKey })` is typed with no generic and no
-       * `schema:` (`INV-SS-TYPES-INFERRED`, `sdk-surfaces-spec.md` decision 7).
+       * `schema:` (`INV-SS-TYPES-INFERRED`, `sdk-surfaces-spec.md` decision 7), and the project's
+       * Functions beside it (REL-4059): `functions` names each one's Fields, so `relyio.functions` holds
+       * exactly those names and each call is typed by them. A project declaring no Function registers no
+       * `functions`, and the accessor stays untyped.
        *
        * It is emitted into this same file rather than a second one: the augmentation takes effect
        * wherever `schema.ts` is part of the program. It needs `'@relyio/sdk'` itself in the program too,
@@ -55300,12 +55387,16 @@ export type ${this.declare("SchemaTypes", "type", "the SchemaTypes export")} = t
        * '@relyio/sdk' cannot be found") even though the name resolves. Two generated files augmenting
        * `Register` in one program conflict on `schema` (TS2717); one program registers one schema.
        */
-      addRegisterAugmentation() {
-        this.output.push(`// Registers this schema with the SDK: \`createClient({ apiKey })\` is typed by it
+      addRegisterAugmentation(functions) {
+        const registered = functions.length === 0 ? "" : `    functions: {
+${functions.map(({ name, varName }) => `      ${this.propertyKey(name)}: typeof ${varName}
+`).join("")}    }
+`;
+        this.output.push(`// Registers this schema with the SDK: \`createClient({ apiKey })\` is typed by it${functions.length === 0 ? "" : ", and `relyio.functions` by its Functions"}
 declare module '@relyio/sdk' {
   interface Register {
     schema: typeof schema
-  }
+${registered}  }
 }
 `);
       }
@@ -55492,14 +55583,17 @@ async function writeExtensionsSource(declared, format2) {
   if (format2 === void 0) return { content: source, warnings };
   return { content: await format2(source), warnings };
 }
-async function generateTypeScript2(rawSchema, options = {}) {
+async function generateTypeScript2(rawSchema, options) {
   return generateTypeScript(rawSchema, options, formatWithPrettier);
 }
-async function generateTypeScriptFromSchema2(rawSchema, options = {}) {
+async function generateTypeScriptFromSchema2(rawSchema, options) {
   return generateTypeScriptFromSchema(rawSchema, options, formatWithPrettier);
 }
 async function exportSchemaSource(definition) {
-  return generateTypeScript2({ data: withoutManagedRecordTypes(definition) }, { purpose: "export" });
+  return generateTypeScript2(
+    { data: withoutManagedRecordTypes(definition) },
+    { purpose: "export", functions: {} }
+  );
 }
 function withoutManagedRecordTypes(definition) {
   const { recordTypes } = definition;
@@ -55519,7 +55613,7 @@ async function exportExtensionsSource(declared) {
 var SDK_AUTOMATIONS, BUILDERS, EXTENSIONS, RESERVED2, SHORTHAND_OPERATORS, HANDLES, IN_STEPS, EVENT_ONLY, WHERE_BECOMES, AutomationWriter, SDK_EXTENSIONS, formatWithPrettier, plugin, index_default;
 var init_dist7 = __esm({
   "../codegen-typescript/dist/index.js"() {
-    init_chunk_57IQB4TX();
+    init_chunk_TPUN4ZUQ();
     init_dist6();
     init_dist3();
     init_dist5();
@@ -55603,7 +55697,10 @@ var init_dist7 = __esm({
         const steps = automationStepsInOrder(this.definition.steps);
         const agents = steps.filter((step) => step.kind === "agent");
         if (agents.length > 0) {
-          const generator = new TypeScriptGenerator(parseSchema({}), { purpose: "export" });
+          const generator = new TypeScriptGenerator(parseSchema({}), {
+            purpose: "export",
+            functions: {}
+          });
           const written = generator.keyedFieldRecords(
             agents.map((agent) => ({ fields: agent.output, owner: `step '${agent.name}'` })),
             file2
@@ -56063,12 +56160,14 @@ ${declarations.map((line) => `    ${line}`).join("\n")}
     };
     plugin = {
       language: "typescript",
-      async generate(ir, options) {
+      async generate(ir, options, functions) {
         const { content, warnings } = await generateTypeScript2(
           { data: ir },
           {
             ...options,
-            fileName: options.fileName || "schema.ts"
+            fileName: options.fileName || "schema.ts",
+            // The project's Functions, registered beside the schema (REL-4059)
+            functions
           }
         );
         return {
@@ -57529,6 +57628,9 @@ _resolve_postponed_annotations()
 `;
     plugin2 = {
       language: "python",
+      // The Functions are not read: no Python client calls one, so no Python type is a Function call's.
+      // A model of each Function's input and output, for a caller of `POST /v1/functions/{name}`, is
+      // not built (REL-4059 typed the TypeScript SDK's call only)
       async generate(ir, options) {
         return generatePython(ir, options);
       }
@@ -61256,7 +61358,7 @@ var init_banner = __esm({
     init_dev_cockpit_context();
     init_dev_cockpit_format();
     init_startup_info();
-    CLI_VERSION2 = "0.14.0" ;
+    CLI_VERSION2 = "0.15.0" ;
     BRAND_GLYPH = "\u25B6";
     BRAND_NAME = "RelyIO";
     LABEL_WIDTH = 9;
@@ -69396,8 +69498,6 @@ init_config();
 // src/commands/promote.ts
 init_manage();
 init_manage_error();
-init_manifest();
-init_schema();
 
 // src/api/sandbox.ts
 init_client2();
@@ -69456,6 +69556,14 @@ async function promoteSandbox(projectId, branchId, body) {
     )
   );
 }
+async function planPromote(projectId, branchId, body) {
+  return readPayload2(
+    await client_default.post(
+      `/projects/${projectId}/branches/${branchId}/sandbox/promote/plan`,
+      body
+    )
+  );
+}
 var sandbox_default = {
   createOrResumeSandbox,
   listSandboxes,
@@ -69463,7 +69571,8 @@ var sandbox_default = {
   resumeSandbox,
   setSandboxPinned,
   discardSandbox,
-  promoteSandbox
+  promoteSandbox,
+  planPromote
 };
 
 // src/api/tasks.ts
@@ -69708,10 +69817,7 @@ function reportPromotionFailure(error2, body) {
 async function readPromotePlan(projectId, sandboxBranchId, targetBranchId) {
   const spinner = out.spinner("Reading the plan...");
   try {
-    const sandboxSchema = await schema_default.getCurrentSchema(projectId, sandboxBranchId);
-    const plan = await planManifest(projectId, targetBranchId, {
-      schema: sandboxSchema.schemaDefinition
-    });
+    const plan = await sandbox_default.planPromote(projectId, sandboxBranchId, { targetBranchId });
     spinner.stop();
     return plan;
   } catch (error2) {
@@ -69720,6 +69826,19 @@ async function readPromotePlan(projectId, sandboxBranchId, targetBranchId) {
     throw exitWith(EXIT_ERROR);
   }
 }
+var PROMOTED_FUNCTION_DONE = {
+  create: "created",
+  change: "changed",
+  delete: "deleted"
+};
+function reportPromotedFunctions(functions, targetName) {
+  if (functions.length === 0) {
+    out.info(`Functions: none changed on "${targetName}"`);
+    return;
+  }
+  const named2 = functions.map((fn) => `${fn.name} (${PROMOTED_FUNCTION_DONE[fn.action]})`);
+  out.success(`Functions promoted to "${targetName}": ${named2.join(", ")}`);
+}
 async function handlePromote(options) {
   const acceptPlanError = acceptPlanOptionError(options.acceptPlan);
   if (acceptPlanError !== void 0) {
@@ -69754,6 +69873,9 @@ async function handlePromote(options) {
   console.log(style.primary("\u2502  ") + style.muted(`Sandbox: ${sandbox.branch.name}`));
   console.log(style.primary("\u2502  ") + style.muted(`Target:  ${target.name}`));
   console.log(style.primary("\u2502  ") + style.muted(`Schema:  flushed via full deploy`));
+  console.log(
+    style.primary("\u2502  ") + style.muted(`Functions: carried when the sandbox deployed its own`)
+  );
   console.log(
     style.primary("\u2502  ") + style.muted(`Writes:  ${withEntries ? "applied to the target as changes" : "not applied"}`)
   );
@@ -69825,6 +69947,7 @@ async function handlePromote(options) {
       result.schemaChanged ? `Schema deployed to "${target.name}"${result.deployedVersion ? ` (v${result.deployedVersion})` : ""}` : `Schema already in sync with "${target.name}"`
     );
   }
+  reportPromotedFunctions(result.functions, target.name);
   if (result.adaptation) displayQueuedAdaptation(result.adaptation, null);
   if (result.entriesTaskId) {
     const entriesSpinner = out.spinner("Applying sandbox writes as changes...");
@@ -69886,10 +70009,14 @@ Examples:
 
 Notes:
   \u2022 The schema is flushed through the standard deploy (full validation + events).
+  \u2022 Functions the sandbox deployed go with it, through the same deploy, and the
+    promote names each one it created, changed or deleted on the target. A sandbox
+    that deployed none leaves the target's Functions as they are.
   \u2022 The sandbox's writes are applied to the target as changes, not copied: an entry it
     created is added under its own id, one it edited is updated in place, one it
     deleted is deleted. They run as a background task, safe for large sets.
-  \u2022 If the target branch changed since your sandbox forked, promotion is blocked and
+  \u2022 If the target branch changed since your sandbox forked \u2014 its schema, or the
+    Functions it runs when your sandbox deployed Functions \u2014 promotion is blocked and
     you'll be asked to rebase (start a fresh \`relyio dev\` from the updated branch).
   \u2022 A sandbox schema that would delete, archive or fill the target's stored content
     prints its plan first, and you are asked once, with the plan in front of you. -y
@@ -70955,7 +71082,7 @@ function sandboxCommands(program2) {
 }
 
 // src/commands/version.ts
-var CLI_VERSION = "0.14.0" ;
+var CLI_VERSION = "0.15.0" ;
 async function handleVersion(_options) {
   out.heading("RelyIO CLI Version Information");
   const versionInfo = [
@@ -71223,7 +71350,9 @@ async function performStatusCheck(branchName, options) {
             }
             const divergence = await manage_default.getBranchDivergence(ctx.projectId, ctx.branchId);
             ctx.divergence = divergence;
-            if (divergence?.hasDiverged) {
+            if (divergence?.source === "deleted") {
+              task.title = divergence.forkedFromBranchName === null ? "Parent branch was deleted" : `Parent branch "${divergence.forkedFromBranchName}" was deleted`;
+            } else if (divergence?.hasDiverged) {
               task.title = `Parent branch "${divergence.forkedFromBranchName}" has diverged`;
             } else if (divergence) {
               task.title = `Up to date with "${divergence.forkedFromBranchName}"`;
@@ -71458,7 +71587,7 @@ function displayCompactStatus(context, failure) {
   }
   out.line("info", branchInfo);
   console.log();
-  if (context.divergence?.hasDiverged) {
+  if (context.divergence?.source === "present" && context.divergence.hasDiverged) {
     const parentName = context.divergence.forkedFromBranchName;
     if (context.divergence.compatibility?.safeToMerge) {
       out.line(
@@ -71506,7 +71635,7 @@ async function displayVerboseStatus(context, failure, watchMode) {
   if (currentGitSha) {
     out.info(`Git commit: ${currentGitSha.slice(0, 8)}...`, "git");
   }
-  if (context.divergence?.hasDiverged) {
+  if (context.divergence?.source === "present" && context.divergence.hasDiverged) {
     const parentName = context.divergence.forkedFromBranchName;
     const changes = context.divergence.parentChanges;
     if (changes) {
@@ -71532,8 +71661,13 @@ async function displayVerboseStatus(context, failure, watchMode) {
         `Parent has ${context.divergence.compatibility.breakingChanges.length} breaking change(s). Review with 'relyio diff --against ${parentName}'.`
       );
     }
-  } else if (context.divergence && !context.divergence.hasDiverged) {
+  } else if (context.divergence?.source === "present") {
     out.info(`Up to date with "${context.divergence.forkedFromBranchName}"`);
+  } else if (context.divergence?.source === "deleted") {
+    const parentName = context.divergence.forkedFromBranchName;
+    out.info(
+      parentName === null ? "Parent branch was deleted" : `Parent branch "${parentName}" was deleted`
+    );
   }
   if (failure?.code === "BRANCH_NOT_FOUND") {
     out.error(`No RelyIO branch named '${context.branchName}' found`);
@@ -71819,6 +71953,9 @@ async function writeFiles(files, outputDir) {
   );
 }
 
+// src/commands/generate-types.ts
+init_functions_loader();
+
 // src/codegen/built-in-generators.ts
 init_dist6();
 var BUILT_IN_GENERATOR_LOADERS = Object.freeze({
@@ -72050,6 +72187,23 @@ async function performTypeGeneration(branchName, options, watchMode = false) {
           ctx.ir = result.schema;
         }
       },
+      {
+        // The project's Functions, so `relyio.functions.<name>(input)` is typed by each one's
+        // Fields (REL-4059). A file that does not load is refused, naming it, as deploy refuses it
+        title: "Loading Functions",
+        task: async (ctx, task) => {
+          const loaded = await loadFunctionDeclarations(process.cwd());
+          if (loaded.errors.length > 0) {
+            throw new Error(
+              `${loaded.errors.length} Function file${loaded.errors.length === 1 ? "" : "s"} could not be read:
+${loaded.errors.map((error2) => `  ${error2.file}: ${error2.error}`).join("\n")}`
+            );
+          }
+          ctx.functions = functionsIrOf(loaded.functions);
+          const count3 = loaded.functions.length;
+          task.title = `${count3} Function${count3 === 1 ? "" : "s"} loaded`;
+        }
+      },
       {
         title: "Generating types",
         task: async (ctx, task) => {
@@ -72060,7 +72214,11 @@ async function performTypeGeneration(branchName, options, watchMode = false) {
               task: async () => {
                 const plugin3 = await loadPlugin(language);
                 const target = resolveTarget(ctx.config || {}, options, language);
-                const result = await plugin3.generate(ctx.ir, target.options);
+                const { functions } = ctx;
+                if (functions === void 0) {
+                  throw new Error("The Functions were not read before the types were generated");
+                }
+                const result = await plugin3.generate(ctx.ir, target.options, functions);
                 await writeFiles(result.files, target.output);
                 if (result.warnings?.length) {
                   for (const warning of result.warnings) {
@@ -72581,7 +72739,8 @@ async function handlePlan(options) {
         success: true,
         branchName: result.branchName,
         branchId: result.branchId,
-        plan: result.plan
+        plan: result.plan,
+        deploy: result.deploy
       },
       refused ? EXIT_BLOCKED : void 0
     );
@@ -72590,6 +72749,7 @@ async function handlePlan(options) {
   console.log(`Plan for ${result.branchName} (${result.branchId.slice(0, 8)})`);
   console.log();
   console.log(formatManifestPlan(result.plan));
+  console.log(formatDeployNote(result.deploy));
   console.log();
   if (refused) throw exitWith(EXIT_BLOCKED);
 }
@@ -72615,8 +72775,10 @@ Examples:
 
 Each area lists one line per item it creates (+), changes (~) or deletes (-). A line that deletes
 or rewrites stored data needs confirming before it deploys; the plan says plainly when none does.
+Last, it says whether deploying from here would be refused: on a Repo-mode main the repository
+deploys it, so open a pull request with the change instead.
 
-Exit codes: 0 a plan, 2 deploy would refuse it, 1 no plan could be read.
+Exit codes: 0 a plan, 2 deploy would refuse the plan, 1 no plan could be read.
 `
   );
 }
@@ -75527,9 +75689,12 @@ function printTestRun(ran, io) {
     io.log(`  recorded ${request2.method} ${request2.url} (not sent: Preview)`);
   }
   for (const refusal2 of ran.run.refusals) {
-    io.log(`  refused  ${refusal2.method} ${refusal2.host} (${refusal2.reason})`);
+    io.log(`  refused  ${refusalLine(refusal2)}`);
   }
 }
+function refusalLine(refusal2) {
+  return `${refusal2.method} ${refusal2.host ?? "an unknown host"} (${refusal2.reason})`;
+}
 function inputOf2(text) {
   if (text === void 0) return {};
   let parsed;
@@ -75571,14 +75736,17 @@ async function runFunctionsLogs(name, options, io, clock = FOREVER) {
 async function printRun(projectId, branchId, name, run4, io) {
   const timing = [
     run4.durationMs === null ? null : `${run4.durationMs} ms`,
-    run4.cpuMs === null ? null : `cpu ${run4.cpuMs} ms`
+    run4.cpuMs === null ? null : `cpu ${run4.cpuMs} ms`,
+    // A Container run is billed as its instance type's vCPU × its running time (REL-4075)
+    run4.container === null ? null : `container ${run4.container.size}`,
+    run4.runningMs === null ? null : `running ${run4.runningMs} ms`
   ].filter((part) => part !== null).join(", ");
   io.log(
     `${run4.startedAt}  ${run4.id}  ${run4.status}${timing === "" ? "" : `  (${timing})`}  v${run4.version} ${run4.wayIn} ${callerOf(run4)}${run4.attempt > 1 ? ` attempt ${run4.attempt}` : ""}`
   );
   if (run4.error !== null) io.log(`  ${run4.error.name}: ${run4.error.message}`);
   for (const refusal2 of run4.refusals) {
-    io.log(`  refused ${refusal2.method} ${refusal2.host} (${refusal2.reason})`);
+    io.log(`  refused ${refusalLine(refusal2)}`);
   }
   if (run4.logLines === 0) return;
   try {
@@ -75811,7 +75979,7 @@ function secretsCommands(program2) {
 init_dist3();
 
 // ../sdk/dist/preview/index.js
-init_chunk_T7LGREB3();
+init_chunk_OUR7OUUZ();
 
 // src/api/ci.ts
 init_dist3();
@@ -75899,7 +76067,7 @@ init_deploy_service();
 
 // src/services/generated-types.ts
 init_dist6();
-async function compareGeneratedTypes(schema, projectRoot) {
+async function compareGeneratedTypes(schema, functions, projectRoot) {
   const configPath = await findCodegenConfig(projectRoot);
   if (configPath === void 0) return { kind: "not-compared" };
   const config = await loadCodegenConfig(configPath);
@@ -75909,7 +76077,7 @@ async function compareGeneratedTypes(schema, projectRoot) {
   for (const language of languages) {
     const target = resolveTarget(config, {}, language);
     const plugin3 = await loadPlugin(language);
-    const generated = await plugin3.generate(schema, target.options);
+    const generated = await plugin3.generate(schema, target.options, functions);
     for (const file2 of generated.files) {
       const absolute = path7.resolve(projectRoot, target.output, file2.path);
       const committed = await readFile(absolute, "utf8").catch((error2) => {
@@ -75927,6 +76095,7 @@ async function compareGeneratedTypes(schema, projectRoot) {
 // src/commands/ci.ts
 init_plan_service();
 init_deploy_plan();
+init_functions_loader();
 init_exit_codes();
 init_schema_loader();
 var defaultIo2 = () => ({
@@ -75990,7 +76159,8 @@ function projectOf(io, named2) {
 }
 var NO_WORK_FOR_THIS_JOB = /* @__PURE__ */ new Set([
   "event-not-accepted",
-  "not-a-branch-push"
+  "not-a-branch-push",
+  "pull-request-closed"
 ]);
 function nothingToDo(io, message) {
   annotate(io, "notice", message);
@@ -76209,12 +76379,13 @@ async function checkPullRequest(io, { projectId, ci }) {
       io.log(`  ${error2.path}: ${error2.message}`);
     return refuse3(io, `${items.error.message} Nothing was checked.`, items.error.code);
   }
-  const generatedTypes = ci.schemaMode === "repo" ? await compareGeneratedTypes(loaded.schema, io.cwd) : { kind: "not-compared" };
+  const generatedTypes = ci.schemaMode === "repo" ? await compareGeneratedTypes(loaded.schema, functionsIrOf(items.functions), io.cwd) : { kind: "not-compared" };
   let answer;
   try {
     answer = await submitSchemaCheck(projectId, {
       schema: loaded.schema,
       generatedTypes,
+      functions: functionsDeclarationOf(items.functions),
       automations: items.automations,
       extensions: items.extensions
     });
@@ -77553,7 +77724,7 @@ Examples:
 }
 
 // src/index.ts
-var CLI_VERSION3 = "0.14.0" ;
+var CLI_VERSION3 = "0.15.0" ;
 var program = new Command();
 program.name("relyio").description("RelyIO CLI - Content Management, Simplified").version(CLI_VERSION3);
 registerGlobalOptions(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relyio/cli",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "RelyIO is coming soon — this package is not ready for general use yet.",
   "bugs": {
     "email": "team@relyio.com"
@@ -62,17 +62,17 @@
     "tsup": "8.5.1",
     "typescript": "npm:@typescript/typescript6@6.0.2",
     "typescript-eslint": "8.69.0",
-    "vitest": "4.1.11",
-    "@relyio/api-contract": "0.1.0",
+    "vitest": "5.0.5",
+    "@relyio/codegen-core": "1.0.0",
     "@relyio/codegen-python": "0.1.0",
     "@relyio/codegen-typescript": "1.0.0",
     "@relyio/device-auth": "0.0.0",
+    "@relyio/api-contract": "0.1.0",
     "@relyio/eslint-config": "0.0.0",
     "@relyio/manifest": "0.0.0",
-    "@relyio/codegen-core": "1.0.0",
     "@relyio/schema": "0.0.1",
-    "@relyio/sdk": "0.19.0",
-    "@relyio/tenancy": "0.1.0"
+    "@relyio/tenancy": "0.1.0",
+    "@relyio/sdk": "0.20.0"
   },
   "publishConfig": {
     "access": "public"