@telorun/templating 0.8.0 → 0.9.0

package/README.md

@@ -55,8 +55,8 @@ metadata:
     A complete feedback collection REST API — no code, pure YAML.
     Persists entries to SQLite and serves them over HTTP.
 imports:
-  Http: std/http-server@0.9.0
-  Sql: std/sql@0.8.0
+  Http: std/http-server@0.11.0
+  Sql: std/sql@0.9.0
 targets:
   - !ref Migrations
   - !ref Server

package/dist/cel/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/cel/catalog.ts"],"names":[],"mappings":"AAEA;;;0DAG0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAClE,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,MAAM,GACN,MAAM,GACN,QAAQ,GACR,MAAM,GACN,YAAY,GACZ,MAAM,GACN,UAAU,GACV,SAAS,GACT,MAAM,CAAC;AAEX;;;qBAGqB;AACrB,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;0EACsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;yDAIqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;wBACoB;IACpB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC;2EACuE;IACvE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;CACjE;AAED,wEAAwE;AACxE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;AAyE5D,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EAoZlD,CAAC;AAEF,oEAAoE;AACpE,wBAAgB,kBAAkB,IAAI,eAAe,EAAE,CAEtD"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/cel/catalog.ts"],"names":[],"mappings":"AAEA;;;0DAG0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAClE,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,MAAM,GACN,MAAM,GACN,QAAQ,GACR,MAAM,GACN,YAAY,GACZ,MAAM,GACN,UAAU,GACV,SAAS,GACT,MAAM,CAAC;AAEX;;;qBAGqB;AACrB,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;0EACsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;yDAIqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;wBACoB;IACpB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC;2EACuE;IACvE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;CACjE;AAED,wEAAwE;AACxE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;AA8E5D,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EAoelD,CAAC;AAEF,oEAAoE;AACpE,wBAAgB,kBAAkB,IAAI,eAAe,EAAE,CAEtD"}

package/dist/cel/catalog.js

@@ -14,6 +14,9 @@ const minMax = (list, isMin) => {
     }
     return best;
 };
+/** Ensure a regex replaces every match: append the global flag unless the
+ *  caller already passed it. */
+const withGlobal = (flags) => flags && flags.includes("g") ? flags : `${flags ?? ""}g`;
 const sortList = (list) => [...list].sort((a, b) => {
     if (typeof a === "number" || typeof a === "bigint") {
         const d = num(a) - num(b);
@@ -130,6 +133,24 @@ export const CEL_FUNCTIONS = [
         hostBacked: false,
         build: () => (list) => sortList(list),
     },
+    {
+        name: "range",
+        signature: "range(int): list<int>",
+        category: "collection",
+        summary: "Integers [0, n-1] (empty for n <= 0); materializes indices for an unknown-length list.",
+        deterministic: true,
+        hostBacked: false,
+        build: () => (n) => Array.from({ length: Math.max(0, Math.trunc(num(n))) }, (_unused, i) => BigInt(i)),
+    },
+    {
+        name: "enumerate",
+        signature: "enumerate(list): list",
+        category: "collection",
+        summary: "Pair each element with its zero-based position as {index, value}.",
+        deterministic: true,
+        hostBacked: false,
+        build: () => (list) => list.map((value, i) => ({ index: BigInt(i), value })),
+    },
     // Strings
     {
         name: "lower",
@@ -176,6 +197,63 @@ export const CEL_FUNCTIONS = [
         hostBacked: false,
         build: () => (s, sep) => s.split(sep),
     },
+    {
+        name: "regexReplace",
+        signature: "regexReplace(string, string, string, string?): string",
+        category: "string",
+        summary: "Replace every regex match with a replacement ($1 backrefs); flags like 'i', 'm', 's'.",
+        deterministic: true,
+        hostBacked: false,
+        build: () => (s, pattern, replacement, flags) => s.replace(new RegExp(pattern, withGlobal(flags)), replacement),
+    },
+    {
+        name: "regexExtract",
+        signature: "regexExtract(string, string): string",
+        category: "string",
+        summary: "First whole match of a regex, or '' when there is none.",
+        deterministic: true,
+        hostBacked: false,
+        build: () => (s, pattern) => s.match(new RegExp(pattern))?.[0] ?? "",
+    },
+    {
+        name: "regexExtractAll",
+        signature: "regexExtractAll(string, string): list<string>",
+        category: "string",
+        summary: "Every whole match of a regex, in order.",
+        deterministic: true,
+        hostBacked: false,
+        build: () => (s, pattern) => [...s.matchAll(new RegExp(pattern, "g"))].map((m) => m[0]),
+    },
+    {
+        name: "regexGroups",
+        signature: "regexGroups(string, string): list<string>",
+        category: "string",
+        summary: "Capture groups of the first regex match (empty list when there is no match).",
+        deterministic: true,
+        hostBacked: false,
+        build: () => (s, pattern) => {
+            const m = s.match(new RegExp(pattern));
+            return m ? m.slice(1).map((g) => g ?? "") : [];
+        },
+    },
+    {
+        name: "trimPrefix",
+        signature: "trimPrefix(string, string): string",
+        category: "string",
+        summary: "Strip a leading prefix if present.",
+        deterministic: true,
+        hostBacked: false,
+        build: () => (s, prefix) => (s.startsWith(prefix) ? s.slice(prefix.length) : s),
+    },
+    {
+        name: "trimSuffix",
+        signature: "trimSuffix(string, string): string",
+        category: "string",
+        summary: "Strip a trailing suffix if present.",
+        deterministic: true,
+        hostBacked: false,
+        build: () => (s, suffix) => suffix && s.endsWith(suffix) ? s.slice(0, s.length - suffix.length) : s,
+    },
     // Math
     {
         name: "abs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/templating",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Telo Templating - Engine registry and shared CEL core for Telo manifests.",
   "keywords": [
     "telo",
@@ -44,7 +44,7 @@
     "@types/uuid": "^10.0.0",
     "typescript": "^5.0.0",
     "vitest": "^2.1.8",
-    "@telorun/sdk": "0.23.0"
+    "@telorun/sdk": "0.26.0"
   },
   "peerDependencies": {
     "@telorun/sdk": "*"

package/src/cel/catalog.ts

@@ -73,6 +73,11 @@ const minMax = (list: unknown[], isMin: boolean): unknown => {
   return best;
 };
 
+/** Ensure a regex replaces every match: append the global flag unless the
+ *  caller already passed it. */
+const withGlobal = (flags?: string): string =>
+  flags && flags.includes("g") ? flags : `${flags ?? ""}g`;
+
 const sortList = (list: unknown[]): unknown[] =>
   [...list].sort((a, b) => {
     if (typeof a === "number" || typeof a === "bigint") {
@@ -195,6 +200,26 @@ export const CEL_FUNCTIONS: readonly CelFunctionDoc[] = [
     hostBacked: false,
     build: () => (list: unknown[]) => sortList(list),
   },
+  {
+    name: "range",
+    signature: "range(int): list<int>",
+    category: "collection",
+    summary: "Integers [0, n-1] (empty for n <= 0); materializes indices for an unknown-length list.",
+    deterministic: true,
+    hostBacked: false,
+    build: () => (n: unknown) =>
+      Array.from({ length: Math.max(0, Math.trunc(num(n))) }, (_unused, i) => BigInt(i)),
+  },
+  {
+    name: "enumerate",
+    signature: "enumerate(list): list",
+    category: "collection",
+    summary: "Pair each element with its zero-based position as {index, value}.",
+    deterministic: true,
+    hostBacked: false,
+    build: () => (list: unknown[]) =>
+      list.map((value, i) => ({ index: BigInt(i), value })),
+  },
   // Strings
   {
     name: "lower",
@@ -241,6 +266,66 @@ export const CEL_FUNCTIONS: readonly CelFunctionDoc[] = [
     hostBacked: false,
     build: () => (s: string, sep: string) => s.split(sep),
   },
+  {
+    name: "regexReplace",
+    signature: "regexReplace(string, string, string, string?): string",
+    category: "string",
+    summary: "Replace every regex match with a replacement ($1 backrefs); flags like 'i', 'm', 's'.",
+    deterministic: true,
+    hostBacked: false,
+    build: () => (s: string, pattern: string, replacement: string, flags?: string) =>
+      s.replace(new RegExp(pattern, withGlobal(flags)), replacement),
+  },
+  {
+    name: "regexExtract",
+    signature: "regexExtract(string, string): string",
+    category: "string",
+    summary: "First whole match of a regex, or '' when there is none.",
+    deterministic: true,
+    hostBacked: false,
+    build: () => (s: string, pattern: string) => s.match(new RegExp(pattern))?.[0] ?? "",
+  },
+  {
+    name: "regexExtractAll",
+    signature: "regexExtractAll(string, string): list<string>",
+    category: "string",
+    summary: "Every whole match of a regex, in order.",
+    deterministic: true,
+    hostBacked: false,
+    build: () => (s: string, pattern: string) =>
+      [...s.matchAll(new RegExp(pattern, "g"))].map((m) => m[0]),
+  },
+  {
+    name: "regexGroups",
+    signature: "regexGroups(string, string): list<string>",
+    category: "string",
+    summary: "Capture groups of the first regex match (empty list when there is no match).",
+    deterministic: true,
+    hostBacked: false,
+    build: () => (s: string, pattern: string) => {
+      const m = s.match(new RegExp(pattern));
+      return m ? m.slice(1).map((g) => g ?? "") : [];
+    },
+  },
+  {
+    name: "trimPrefix",
+    signature: "trimPrefix(string, string): string",
+    category: "string",
+    summary: "Strip a leading prefix if present.",
+    deterministic: true,
+    hostBacked: false,
+    build: () => (s: string, prefix: string) => (s.startsWith(prefix) ? s.slice(prefix.length) : s),
+  },
+  {
+    name: "trimSuffix",
+    signature: "trimSuffix(string, string): string",
+    category: "string",
+    summary: "Strip a trailing suffix if present.",
+    deterministic: true,
+    hostBacked: false,
+    build: () => (s: string, suffix: string) =>
+      suffix && s.endsWith(suffix) ? s.slice(0, s.length - suffix.length) : s,
+  },
   // Math
   {
     name: "abs",