@telorun/sdk 0.19.0 → 0.21.0

package/dist/compiled-value.d.ts

@@ -5,7 +5,25 @@ export interface CompiledValue {
     readonly __compiled: true;
     /** Original expression source text (e.g. "env.PORT"), if available. */
     readonly source?: string;
+    /** For an interpolated string ("a ${{ x }} b"), the ordered literal
+     *  fragments and embedded expression segments before they are joined into a
+     *  single string by `call()`. Absent for a bare single expression. Consumers
+     *  that need each interpolation as a separate value (e.g. SQL bind
+     *  parameters) read this instead of the joined `call()` result. */
+    readonly parts?: ReadonlyArray<string | CompiledValue>;
     call(ctx: Record<string, unknown>): unknown;
 }
 export declare function isCompiledValue(v: unknown): v is CompiledValue;
+/** The value a parameterized template (the `!sql` engine) evaluates to: literal
+ *  text fragments plus the separately-evaluated value of each embedded `${{ }}`
+ *  interpolation, with `fragments.length === values.length + 1`. A consumer emits
+ *  its own placeholder between fragments and binds the values — never splicing
+ *  them into the text. Single source of truth for the marker contract shared
+ *  across the producing engine and any consuming controller. */
+export interface ParameterizedSql {
+    readonly __teloParameterized: true;
+    readonly fragments: string[];
+    readonly values: unknown[];
+}
+export declare function isParameterizedSql(v: unknown): v is ParameterizedSql;
 //# sourceMappingURL=compiled-value.d.ts.map

package/dist/compiled-value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiled-value.d.ts","sourceRoot":"","sources":["../src/compiled-value.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CAC7C;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAE9D"}
+{"version":3,"file":"compiled-value.d.ts","sourceRoot":"","sources":["../src/compiled-value.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;uEAImE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;IACvD,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CAC7C;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAE9D;AAED;;;;;gEAKgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,gBAAgB,CAIpE"}

package/dist/compiled-value.js

@@ -1,3 +1,6 @@
 export function isCompiledValue(v) {
     return v !== null && typeof v === "object" && v.__compiled === true;
 }
+export function isParameterizedSql(v) {
+    return (v !== null && typeof v === "object" && v.__teloParameterized === true);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/sdk",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "description": "Telo SDK - Public API for Telo module authors.",
   "keywords": [
     "telo",

package/src/compiled-value.ts

@@ -5,9 +5,33 @@ export interface CompiledValue {
   readonly __compiled: true;
   /** Original expression source text (e.g. "env.PORT"), if available. */
   readonly source?: string;
+  /** For an interpolated string ("a ${{ x }} b"), the ordered literal
+   *  fragments and embedded expression segments before they are joined into a
+   *  single string by `call()`. Absent for a bare single expression. Consumers
+   *  that need each interpolation as a separate value (e.g. SQL bind
+   *  parameters) read this instead of the joined `call()` result. */
+  readonly parts?: ReadonlyArray<string | CompiledValue>;
   call(ctx: Record<string, unknown>): unknown;
 }
 
 export function isCompiledValue(v: unknown): v is CompiledValue {
   return v !== null && typeof v === "object" && (v as any).__compiled === true;
 }
+
+/** The value a parameterized template (the `!sql` engine) evaluates to: literal
+ *  text fragments plus the separately-evaluated value of each embedded `${{ }}`
+ *  interpolation, with `fragments.length === values.length + 1`. A consumer emits
+ *  its own placeholder between fragments and binds the values — never splicing
+ *  them into the text. Single source of truth for the marker contract shared
+ *  across the producing engine and any consuming controller. */
+export interface ParameterizedSql {
+  readonly __teloParameterized: true;
+  readonly fragments: string[];
+  readonly values: unknown[];
+}
+
+export function isParameterizedSql(v: unknown): v is ParameterizedSql {
+  return (
+    v !== null && typeof v === "object" && (v as any).__teloParameterized === true
+  );
+}