flowdular 0.3.1 → 0.4.0

package/README.md

@@ -1,4 +1,4 @@
-[![Flowdular: Build your business platform](https://cdn.jsdelivr.net/npm/flowdular@latest/assets/flowdular-banner.png)](https://flowdular.com)
+[![Flowdular: Build your business platform](https://cdn.jsdelivr.net/npm/flowdular@latest/assets/flowdular-banner.webp)](https://flowdular.com)
 
 # Flowdular CLI
 

package/dist/distribution.js

@@ -2478,6 +2478,17 @@ var module_spec_schema_default = {
       type: "array",
       items: { $ref: "#/$defs/decision" },
       uniqueItems: true
+    },
+    research: { $ref: "#/$defs/research" },
+    adapters: {
+      type: "array",
+      items: { $ref: "#/$defs/adapter" },
+      uniqueItems: true
+    },
+    templates: {
+      type: "array",
+      items: { $ref: "#/$defs/template" },
+      uniqueItems: true
     }
   },
   allOf: [
@@ -2495,7 +2506,10 @@ var module_spec_schema_default = {
           settings: false,
           agentTools: false,
           outOfScope: false,
-          decisions: false
+          decisions: false,
+          research: false,
+          adapters: false,
+          templates: false
         }
       }
     }
@@ -2701,6 +2715,113 @@ var module_spec_schema_default = {
         answer: { type: "string", minLength: 1 },
         decidedBy: { enum: ["user", "default"] }
       }
+    },
+    domain: {
+      type: "string",
+      maxLength: 253,
+      pattern: "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$"
+    },
+    research: {
+      type: "object",
+      additionalProperties: false,
+      required: ["adapter", "evidenceOwner"],
+      properties: {
+        adapter: {
+          enum: [
+            "model-native",
+            "searxng",
+            "firecrawl",
+            "connector",
+            "recorded"
+          ]
+        },
+        allowDomains: {
+          type: "array",
+          items: { $ref: "#/$defs/domain" },
+          uniqueItems: true
+        },
+        denyDomains: {
+          type: "array",
+          items: { $ref: "#/$defs/domain" },
+          uniqueItems: true
+        },
+        monthlyQueryBudget: { type: "integer", minimum: 1 },
+        evidenceOwner: { $ref: "#/$defs/entityId" }
+      }
+    },
+    adapter: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "id",
+        "direction",
+        "connector",
+        "operation",
+        "port",
+        "mapping"
+      ],
+      properties: {
+        id: {
+          type: "string",
+          pattern: "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$"
+        },
+        direction: { enum: ["source", "sink"] },
+        connector: { type: "string", pattern: "^[a-z][a-z0-9-]{0,95}$" },
+        operation: { type: "string", pattern: "^[a-z][a-z0-9-]{0,63}$" },
+        port: {
+          type: "string",
+          maxLength: 96,
+          pattern: "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$"
+        },
+        schedule: {
+          anyOf: [
+            { type: "null" },
+            {
+              type: "string",
+              maxLength: 100,
+              pattern: "^[0-9a-z*,/-]+( [0-9a-z*,/-]+){4}$"
+            }
+          ]
+        },
+        mapping: {
+          type: "array",
+          minItems: 1,
+          items: { $ref: "#/$defs/adapterMapping" },
+          uniqueItems: true
+        },
+        recorded: {
+          type: "string",
+          pattern: "^adapters/[a-z0-9][a-z0-9-]*\\.recorded\\.json$"
+        }
+      }
+    },
+    adapterMapping: {
+      type: "object",
+      additionalProperties: false,
+      required: ["to", "transform"],
+      properties: {
+        from: { type: "string", minLength: 1 },
+        to: { type: "string", minLength: 1 },
+        transform: { enum: ["rename", "constant", "format", "lookup"] },
+        value: {
+          anyOf: [{ type: "null" }, { type: "string", minLength: 1 }]
+        }
+      }
+    },
+    template: {
+      type: "object",
+      additionalProperties: false,
+      required: ["id", "title", "inputEntity", "format", "body"],
+      properties: {
+        id: { $ref: "#/$defs/entityId" },
+        title: { type: "string", minLength: 1 },
+        inputEntity: { $ref: "#/$defs/entityId" },
+        format: { enum: ["pdf", "docx"] },
+        body: {
+          type: "string",
+          pattern: "^templates/[a-z][a-z0-9-]*\\.md$"
+        }
+      }
     }
   }
 };
@@ -2867,6 +2988,15 @@ var project_schema_default = {
                     $ref: "#/$defs/githubAccount"
                   },
                   uniqueItems: true
+                },
+                labels: {
+                  type: "array",
+                  maxItems: 10,
+                  items: {
+                    type: "string",
+                    pattern: "^[A-Za-z0-9][A-Za-z0-9 ._:-]{0,49}$"
+                  },
+                  uniqueItems: true
                 }
               }
             },
@@ -3114,8 +3244,79 @@ var projectSchema = project_schema_default;
 var moduleCatalogSchema = module_catalog_schema_default;
 var moduleArtifactSchema = module_artifact_schema_default;
 
+// ../contracts/src/translations.ts
+var PLURAL_CATEGORIES = [
+  "zero",
+  "one",
+  "two",
+  "few",
+  "many",
+  "other"
+];
+var WHOLE_NUMBER_SAMPLES = [
+  ...Array.from({ length: 200 }, (_, index) => index),
+  1e3,
+  1e4,
+  1e5,
+  1e6,
+  1e7,
+  1e8,
+  1e9
+];
+function requiredPluralCategories(locale) {
+  const rules = new Intl.PluralRules(locale);
+  const selected = /* @__PURE__ */ new Set(["other"]);
+  for (const sample of WHOLE_NUMBER_SAMPLES) selected.add(rules.select(sample));
+  return PLURAL_CATEGORIES.filter((category) => selected.has(category));
+}
+function pluralMember(bundle, key) {
+  const dot = key.lastIndexOf(".");
+  if (dot <= 0) return null;
+  const category = key.slice(dot + 1);
+  if (!PLURAL_CATEGORIES.includes(category)) return null;
+  const base = key.slice(0, dot);
+  return Object.hasOwn(bundle, base + ".other") ? { base, category } : null;
+}
+function translationKeys(bundle) {
+  const keys = /* @__PURE__ */ new Set();
+  for (const key of Object.keys(bundle)) {
+    keys.add(pluralMember(bundle, key)?.base ?? key);
+  }
+  return [...keys].sort();
+}
+function pluralFamilyIssues(bundle, locale) {
+  const families = /* @__PURE__ */ new Map();
+  for (const key of Object.keys(bundle)) {
+    const member = pluralMember(bundle, key);
+    if (member === null) continue;
+    const categories = families.get(member.base) ?? /* @__PURE__ */ new Set();
+    categories.add(member.category);
+    families.set(member.base, categories);
+  }
+  const required = requiredPluralCategories(locale);
+  const known = new Intl.PluralRules(
+    locale
+  ).resolvedOptions().pluralCategories;
+  const issues = [];
+  for (const base of [...families.keys()].sort()) {
+    const categories = families.get(base);
+    const missing = required.filter((category) => !categories.has(category));
+    if (missing.length > 0) {
+      issues.push(
+        `${base} lacks ${missing.map((category) => base + "." + category).join(", ")} for ${locale}`
+      );
+    }
+    for (const category of categories) {
+      if (!known.includes(category)) {
+        issues.push(`${base}.${category} is never selected for ${locale}`);
+      }
+    }
+  }
+  return issues;
+}
+
 // ../contracts/src/index.ts
-var PLATFORM_API_VERSION = "0.1.8";
+var PLATFORM_API_VERSION = "0.1.21";
 
 // ../kernel/src/module-compatibility.ts
 function satisfiesModuleVersion(version, range) {
@@ -3298,6 +3499,10 @@ var validators = {
   cliExtension: ajv.compile(cliExtensionSchema),
   platformSpec: ajv.compile(platformSpecSchema)
 };
+var MONTH_NAMES = "jan feb mar apr may jun jul aug sep oct nov dec".split(
+  " "
+);
+var WEEKDAY_NAMES = "sun mon tue wed thu fri sat".split(" ");
 var SKIPPED_DIRECTORIES = /* @__PURE__ */ new Set([
   ".git",
   ".flowdular",
@@ -3796,7 +4001,7 @@ import { dirname as dirname6, join as join6, relative as relative5 } from "node:
 import { createRequire } from "node:module";
 import { readFile as readFile5 } from "node:fs/promises";
 import { dirname as dirname4, join as join3 } from "node:path";
-var SDK_VERSION = "0.3.1";
+var SDK_VERSION = "0.4.0";
 function npmPackage(specifier) {
   return specifier.startsWith("@") ? specifier.split("/").slice(0, 2).join("/") : specifier.split("/")[0];
 }
@@ -3900,6 +4105,115 @@ async function findModuleFiles(workspace) {
 import { access as access2, readFile as readFile7, readdir as readdir3 } from "node:fs/promises";
 import { dirname as dirname5, join as join5, relative as relative4 } from "node:path";
 import { parse as parseYaml3 } from "yaml";
+
+// src/dom-properties.ts
+var DOM_PROPERTY_SPELLINGS = [
+  "acceptCharset",
+  "allowFullScreen",
+  "autoCapitalize",
+  "autoComplete",
+  "autoCorrect",
+  "autoFocus",
+  "autoPlay",
+  "charSet",
+  "contentEditable",
+  "crossOrigin",
+  "defaultChecked",
+  "defaultValue",
+  "disablePictureInPicture",
+  "disableRemotePlayback",
+  "encType",
+  "fetchPriority",
+  "formAction",
+  "formEncType",
+  "formMethod",
+  "formNoValidate",
+  "formTarget",
+  "httpEquiv",
+  "imageSizes",
+  "imageSrcSet",
+  "inputMode",
+  "itemID",
+  "itemProp",
+  "itemRef",
+  "itemScope",
+  "itemType",
+  "maxLength",
+  "noModule",
+  "noValidate",
+  "playsInline",
+  "readOnly",
+  "referrerPolicy",
+  "spellCheck",
+  "srcDoc",
+  "srcLang",
+  "srcSet",
+  "tabIndex",
+  "viewBox"
+];
+var SPELLINGS = new Map(
+  DOM_PROPERTY_SPELLINGS.map((name) => [name.toLowerCase(), name])
+);
+function hostTagAttributes(source) {
+  const tags = [];
+  for (const match of source.matchAll(/<[a-z][a-z0-9-]*/g)) {
+    const start = match.index + match[0].length;
+    let depth = 0;
+    let quote = "";
+    let text = "";
+    let end = start;
+    for (; end < source.length; end += 1) {
+      const character = source[end];
+      if (quote !== "") {
+        if (character === quote) quote = "";
+        text += " ";
+        continue;
+      }
+      if (depth > 0) {
+        if (character === "{") depth += 1;
+        else if (character === "}") depth -= 1;
+        text += depth === 0 ? character : " ";
+        continue;
+      }
+      if (character === "{") {
+        depth = 1;
+        text += character;
+        continue;
+      }
+      if (character === '"' || character === "'") {
+        quote = character;
+        text += character;
+        continue;
+      }
+      if (character === ">") break;
+      text += character;
+    }
+    tags.push({ start, text });
+  }
+  return tags;
+}
+function domPropertyMisspellings(source) {
+  const found = [];
+  for (const tag of hostTagAttributes(source)) {
+    for (const attribute of tag.text.matchAll(
+      /(?<=\s)([A-Za-z][A-Za-z-]*)=/g
+    )) {
+      const name = attribute[1];
+      const expected = SPELLINGS.get(name.toLowerCase());
+      if (expected === void 0 || expected === name) continue;
+      const index = tag.start + attribute.index;
+      found.push({
+        name,
+        expected,
+        index,
+        line: source.slice(0, index).split("\n").length
+      });
+    }
+  }
+  return found.sort((left, right) => left.index - right.index);
+}
+
+// src/module-validate.ts
 function issue(code, message, path, severity = "error") {
   return { code, message, path, severity };
 }
@@ -4088,6 +4402,7 @@ async function translationIssues(moduleRoot, manifest, projectLocales) {
   }
   if (!manifest.capabilities.includes("translations")) return issues;
   const keySets = /* @__PURE__ */ new Map();
+  const referenceBundleKeys = /* @__PURE__ */ new Set();
   for (const locale of manifest.locales) {
     const path = `translations/${locale}.json`;
     if (!await exists(join5(moduleRoot, path))) {
@@ -4105,7 +4420,21 @@ async function translationIssues(moduleRoot, manifest, projectLocales) {
       if (!bundle || typeof bundle !== "object" || Array.isArray(bundle)) {
         throw new Error("Expected a JSON object.");
       }
-      keySets.set(locale, Object.keys(bundle).sort());
+      const strings = bundle;
+      keySets.set(locale, translationKeys(strings));
+      if (keySets.size === 1) {
+        for (const key of Object.keys(strings)) referenceBundleKeys.add(key);
+      }
+      const plurals = pluralFamilyIssues(strings, locale);
+      if (plurals.length > 0) {
+        issues.push(
+          issue(
+            "TRANSLATION_PLURAL_INCOMPLETE",
+            `${path} plural families do not match the ${locale} plural rules: ${plurals.join("; ")}.`,
+            path
+          )
+        );
+      }
     } catch (error) {
       issues.push(
         issue(
@@ -4134,7 +4463,7 @@ async function translationIssues(moduleRoot, manifest, projectLocales) {
       )
     );
   }
-  const referenceKeys = new Set(reference[1]);
+  const referenceKeys = /* @__PURE__ */ new Set([...reference[1], ...referenceBundleKeys]);
   const files = await clientSourceFiles(moduleRoot);
   if (files.length > 0) {
     const namespace = manifest.id.split(".")[0] ?? manifest.id;
@@ -4166,6 +4495,21 @@ async function translationIssues(moduleRoot, manifest, projectLocales) {
   }
   return issues;
 }
+function filtersTags(source) {
+  const tags = [];
+  for (const match of source.matchAll(/<Filters\b/g)) {
+    let depth = 0;
+    let end = match.index + match[0].length;
+    for (; end < source.length; end += 1) {
+      const character = source[end];
+      if (character === "{") depth += 1;
+      else if (character === "}") depth -= 1;
+      else if (character === ">" && depth === 0) break;
+    }
+    tags.push(source.slice(match.index, end));
+  }
+  return tags;
+}
 async function userInterfaceIssues(moduleRoot) {
   const issues = [];
   for (const file of await clientSourceFiles(moduleRoot)) {
@@ -4189,6 +4533,27 @@ async function userInterfaceIssues(moduleRoot) {
         )
       );
     }
+    const misspelled = domPropertyMisspellings(source);
+    if (misspelled.length > 0) {
+      issues.push(
+        issue(
+          "DOM_PROPERTY_CASING",
+          "Host elements use Octane's DOM property spelling: " + misspelled.map(
+            (found) => `line ${found.line} ${found.name} as ${found.expected}`
+          ).join(", ") + ".",
+          path
+        )
+      );
+    }
+    if (filtersTags(source).some((tag) => !/\slabel=/.test(tag))) {
+      issues.push(
+        issue(
+          "FILTERS_LABEL_MISSING",
+          'Filters from @flowdular/ui needs a translated label; without one it shows the English word "Filters" in every locale.',
+          path
+        )
+      );
+    }
   }
   return issues;
 }
@@ -4710,8 +5075,8 @@ import type { WebMount } from '${serverPackage}';
 ` + capabilityScope(module) + `			metrics: createModuleMetrics('${module.id}'),
 		}), moduleId: '${module.id}' },`
   ).join("\n");
-  return GENERATED_HEADER + typeImport + `import { createModuleMetrics } from '${serverPackage}';
-` + imports + "\n\nexport function composeModuleServer(\n	context: PlatformServerContext,\n): readonly PlatformServerComposition[] {\n	return [\n" + calls + "\n	];\n}\n\nexport const moduleWebMounts: readonly WebMount[] = " + JSON.stringify(mounts) + " as const;\nexport const applicationBasePath = " + JSON.stringify(applicationPath) + ";\n";
+  return GENERATED_HEADER + typeImport + `import { bindModuleCompositions, createModuleMetrics } from '${serverPackage}';
+` + imports + "\n\nexport function composeModuleServer(\n	context: PlatformServerContext,\n): readonly PlatformServerComposition[] {\n	return bindModuleCompositions([\n" + calls + "\n	]);\n}\n\nexport const moduleWebMounts: readonly WebMount[] = " + JSON.stringify(mounts) + " as const;\nexport const applicationBasePath = " + JSON.stringify(applicationPath) + ";\n";
 }
 function generateClientComposition(modules, sdk = false, applicationPath = "/app") {
   const client = modules.filter((module) => module.client);