@procedures/client 0.0.0-stage → 0.1.0

package/dist/procedures/core/results.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Aggregation Result Types
+ *
+ * Standardized, consistent result types for all aggregation primitives.
+ * These provide a uniform interface for handling aggregation outcomes.
+ */
+/**
+ * Base result from a single aggregation step or procedure call.
+ *
+ * @example
+ * ```typescript
+ * // Success case
+ * { success: true, value: { id: 1, name: "user" }, duration: 42 }
+ *
+ * // Error case
+ * { success: false, error: "Connection timeout", duration: 5000 }
+ * ```
+ */
+export type StepResult<T> = {
+    success: true;
+    value: T;
+    duration: number;
+} | {
+    success: false;
+    error: string;
+    duration: number;
+};
+/**
+ * Create a successful step result.
+ */
+export declare function successResult<T>(value: T, duration: number): StepResult<T>;
+/**
+ * Create a failed step result.
+ */
+export declare function errorResult<T>(error: string | Error, duration: number): StepResult<T>;
+/**
+ * Result from a chain (sequential) aggregation.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   results: [
+ *     { success: true, value: { created: true }, duration: 100 },
+ *     { success: true, value: { committed: true }, duration: 50 },
+ *   ],
+ *   final: { committed: true },
+ *   success: true,
+ *   duration: 150
+ * }
+ * ```
+ */
+export interface ChainResult<T = unknown> {
+    /** Results from each step in order */
+    results: StepResult<unknown>[];
+    /** The final step's value (or undefined if chain is empty) */
+    final: T | undefined;
+    /** Whether all steps succeeded */
+    success: boolean;
+    /** Total duration of all steps */
+    duration: number;
+}
+/**
+ * Create a chain result from step results.
+ */
+export declare function createChainResult<T>(results: StepResult<unknown>[]): ChainResult<T>;
+/**
+ * Result from a parallel aggregation.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   results: [
+ *     { success: true, value: "pkg1-built", duration: 1000 },
+ *     { success: false, error: "Build failed", duration: 500 },
+ *   ],
+ *   allSucceeded: false,
+ *   errors: [{ index: 1, error: "Build failed" }],
+ *   duration: 1000  // max duration (parallel)
+ * }
+ * ```
+ */
+export interface ParallelResult<T = unknown> {
+    /** Results from each task in order */
+    results: StepResult<T>[];
+    /** Whether all tasks succeeded */
+    allSucceeded: boolean;
+    /** Error details for failed tasks */
+    errors: Array<{
+        index: number;
+        error: string;
+    }>;
+    /** Duration of the longest task (wall-clock time) */
+    duration: number;
+}
+/**
+ * Create a parallel result from task results.
+ */
+export declare function createParallelResult<T>(results: StepResult<T>[]): ParallelResult<T>;
+/**
+ * Result from a conditional aggregation.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   condition: true,
+ *   branch: 'then',
+ *   value: { committed: true },
+ *   success: true,
+ *   duration: 50
+ * }
+ * ```
+ */
+export interface ConditionalResult<T = unknown> {
+    /** The evaluated condition value */
+    condition: boolean;
+    /** Which branch was taken */
+    branch: 'then' | 'else' | 'none';
+    /** The result value from the branch (undefined if no branch taken) */
+    value: T | undefined;
+    /** Whether the branch execution succeeded */
+    success: boolean;
+    /** Duration of the branch execution */
+    duration: number;
+}
+/**
+ * Result from a reduce aggregation.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   accumulator: 150,
+ *   iterations: 3,
+ *   success: true,
+ *   duration: 45
+ * }
+ * ```
+ */
+export interface ReduceResult<T = unknown> {
+    /** The final accumulated value */
+    accumulator: T;
+    /** Number of iterations performed */
+    iterations: number;
+    /** Whether all iterations succeeded */
+    success: boolean;
+    /** Total duration */
+    duration: number;
+}
+/**
+ * Result from a map aggregation.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   items: [
+ *     { success: true, value: "processed-1", duration: 10 },
+ *     { success: true, value: "processed-2", duration: 12 },
+ *   ],
+ *   values: ["processed-1", "processed-2"],
+ *   allSucceeded: true,
+ *   duration: 22
+ * }
+ * ```
+ */
+export interface MapResult<T = unknown> {
+    /** Result for each item */
+    items: StepResult<T>[];
+    /** Just the values (for successful items) */
+    values: T[];
+    /** Whether all items succeeded */
+    allSucceeded: boolean;
+    /** Total duration */
+    duration: number;
+}
+/**
+ * Create a map result from item results.
+ */
+export declare function createMapResult<T>(items: StepResult<T>[]): MapResult<T>;
+/**
+ * Check if a step result is successful.
+ */
+export declare function isSuccess<T>(result: StepResult<T>): result is StepResult<T> & {
+    success: true;
+};
+/**
+ * Check if a step result is an error.
+ */
+export declare function isError<T>(result: StepResult<T>): result is StepResult<T> & {
+    success: false;
+};
+/**
+ * Extract the value from a successful result, or throw on error.
+ */
+export declare function unwrap<T>(result: StepResult<T>): T;
+/**
+ * Extract the value from a successful result, or return a default.
+ */
+export declare function unwrapOr<T>(result: StepResult<T>, defaultValue: T): T;
+/**
+ * Map a successful result's value, passing through errors.
+ */
+export declare function mapResult<T, U>(result: StepResult<T>, fn: (value: T) => U): StepResult<U>;
+//# sourceMappingURL=results.d.ts.map

package/dist/procedures/core/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../src/procedures/core/results.ts"],"names":[],"mappings":"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"}

package/dist/procedures/core/results.js

@@ -0,0 +1,106 @@
+/**
+ * Aggregation Result Types
+ *
+ * Standardized, consistent result types for all aggregation primitives.
+ * These provide a uniform interface for handling aggregation outcomes.
+ */
+/**
+ * Create a successful step result.
+ */
+export function successResult(value, duration) {
+    return { success: true, value, duration };
+}
+/**
+ * Create a failed step result.
+ */
+export function errorResult(error, duration) {
+    const message = error instanceof Error ? error.message : error;
+    return { success: false, error: message, duration };
+}
+/**
+ * Create a chain result from step results.
+ */
+export function createChainResult(results) {
+    const success = results.every(r => r.success);
+    const duration = results.reduce((sum, r) => sum + r.duration, 0);
+    const lastResult = results[results.length - 1];
+    const final = lastResult?.success ? lastResult.value : undefined;
+    return { results, final, success, duration };
+}
+/**
+ * Create a parallel result from task results.
+ */
+export function createParallelResult(results) {
+    const errors = [];
+    results.forEach((result, index) => {
+        if (!result.success) {
+            errors.push({ index, error: result.error });
+        }
+    });
+    return {
+        results,
+        allSucceeded: errors.length === 0,
+        errors,
+        duration: Math.max(...results.map(r => r.duration), 0),
+    };
+}
+/**
+ * Create a map result from item results.
+ */
+export function createMapResult(items) {
+    const values = items
+        .filter((item) => item.success)
+        .map(item => item.value);
+    return {
+        items,
+        values,
+        allSucceeded: items.every(item => item.success),
+        duration: items.reduce((sum, item) => sum + item.duration, 0),
+    };
+}
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * Check if a step result is successful.
+ */
+export function isSuccess(result) {
+    return result.success;
+}
+/**
+ * Check if a step result is an error.
+ */
+export function isError(result) {
+    return !result.success;
+}
+// =============================================================================
+// Result Utilities
+// =============================================================================
+/**
+ * Extract the value from a successful result, or throw on error.
+ */
+export function unwrap(result) {
+    if (result.success) {
+        return result.value;
+    }
+    throw new Error(result.error);
+}
+/**
+ * Extract the value from a successful result, or return a default.
+ */
+export function unwrapOr(result, defaultValue) {
+    if (result.success) {
+        return result.value;
+    }
+    return defaultValue;
+}
+/**
+ * Map a successful result's value, passing through errors.
+ */
+export function mapResult(result, fn) {
+    if (result.success) {
+        return { success: true, value: fn(result.value), duration: result.duration };
+    }
+    return result;
+}
+//# sourceMappingURL=results.js.map

package/dist/procedures/core/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../../src/procedures/core/results.ts"],"names":[],"mappings":"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"}

package/dist/procedures/core/schemas.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Common Schemas
+ *
+ * Shared schema definitions for procedures that accept any input/output, and the adapter of
+ * zod schemas. Every schema here is a Standard Schema v1 (`~standard`), so the core validates
+ * them all through `validateSchema()`.
+ */
+import type { ZodLike, ZodErrorLike } from "../../client/validation/types.js";
+import { type JsonSchema, type StandardSchemaV1 } from "../schema.js";
+export type { ZodLike, ZodErrorLike };
+/**
+ * A `ZodLike` schema with the `_output` phantom field, for type inference. A zod 4 schema is one.
+ */
+export interface ZodLikeSchema<T> extends ZodLike<T> {
+    _output: T;
+}
+/**
+ * A schema that accepts any value and passes it through. Its JSON Schema is `{}` (any value).
+ * Used for procedures with dynamic or unknown input/output types.
+ */
+export declare const anySchema: ZodLike<any> & StandardSchemaV1<unknown, any> & {
+    readonly "~jsonSchema": JsonSchema;
+};
+/**
+ * Typed version of anySchema for specific type annotations.
+ * Useful when you want to assert a specific type at compile time.
+ */
+export declare function typedAnySchema<T>(): ZodLike<T> & StandardSchemaV1<unknown, T>;
+/**
+ * Gives a zod schema the type of a procedure schema (`ZodLikeSchema<T>`). A zod 4 schema is a
+ * Standard Schema already, so the function returns it unchanged: the validation and the JSON
+ * Schema come from zod itself.
+ *
+ * An object with only a `parse` method gets `safeParse` and `~standard` around that method.
+ */
+export declare function zodAdapter<T>(schema: {
+    parse: (data: unknown) => T;
+}): ZodLikeSchema<T>;
+/**
+ * A pass-through schema: it validates nothing and has no JSON Schema. The type parameter only
+ * gives the TypeScript type.
+ *
+ * Use it for internal procedures where a real schema adds nothing. A procedure that an MCP
+ * server exposes, or that a user calls from the CLI, takes a real schema (zod), so its input
+ * is validated and its tools and help describe the fields (roadmap 2.1).
+ */
+export declare function outputSchema<T>(): ZodLikeSchema<T> & StandardSchemaV1<unknown, T>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/procedures/core/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/procedures/core/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAoB,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMxF,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IAClD,OAAO,EAAE,CAAC,CAAC;CACZ;AAeD;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG;IAAE,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAA;CAK3G,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,CAM7E;AAMD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE;IAAE,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,CAAA;CAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CA8BvF;AAMD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,CAOjF"}

package/dist/procedures/core/schemas.js

@@ -0,0 +1,102 @@
+/**
+ * Common Schemas
+ *
+ * Shared schema definitions for procedures that accept any input/output, and the adapter of
+ * zod schemas. Every schema here is a Standard Schema v1 (`~standard`), so the core validates
+ * them all through `validateSchema()`.
+ */
+import { isStandardSchema } from "../schema.js";
+/** The Standard Schema properties of a schema that accepts every value unchanged. */
+function passThrough() {
+    return {
+        version: 1,
+        vendor: "@procedures/client",
+        validate: (value) => ({ value: value }),
+    };
+}
+// =============================================================================
+// Any Schema - Pass-through validation
+// =============================================================================
+/**
+ * A schema that accepts any value and passes it through. Its JSON Schema is `{}` (any value).
+ * Used for procedures with dynamic or unknown input/output types.
+ */
+export const anySchema = {
+    parse: (value) => value,
+    safeParse: (value) => ({ success: true, data: value }),
+    "~standard": passThrough(),
+    "~jsonSchema": {},
+};
+/**
+ * Typed version of anySchema for specific type annotations.
+ * Useful when you want to assert a specific type at compile time.
+ */
+export function typedAnySchema() {
+    return {
+        parse: (value) => value,
+        safeParse: (value) => ({ success: true, data: value }),
+        "~standard": passThrough(),
+    };
+}
+// =============================================================================
+// Zod Adapter - Wraps a Zod schema for the procedure system
+// =============================================================================
+/**
+ * Gives a zod schema the type of a procedure schema (`ZodLikeSchema<T>`). A zod 4 schema is a
+ * Standard Schema already, so the function returns it unchanged: the validation and the JSON
+ * Schema come from zod itself.
+ *
+ * An object with only a `parse` method gets `safeParse` and `~standard` around that method.
+ */
+export function zodAdapter(schema) {
+    if (isStandardSchema(schema) && typeof schema.safeParse === "function") {
+        return schema;
+    }
+    const safeParse = (data) => {
+        try {
+            return { success: true, data: schema.parse(data) };
+        }
+        catch (error) {
+            const err = error;
+            const message = err.message ?? "Validation failed";
+            // A plain Error has no issues: its message is the one issue
+            const issues = err.issues ?? err.errors;
+            return { success: false, error: { message, issues: issues && issues.length > 0 ? issues : [{ message }] } };
+        }
+    };
+    return {
+        parse: (data) => schema.parse(data),
+        safeParse,
+        _output: undefined,
+        "~standard": {
+            version: 1,
+            vendor: "@procedures/client",
+            validate: (value) => {
+                const result = safeParse(value);
+                return result.success
+                    ? { value: result.data }
+                    : { issues: (result.error.issues ?? []).map((issue) => ({ message: issue.message, path: issue.path })) };
+            },
+        },
+    };
+}
+// =============================================================================
+// Output Schema - Pass-through schema for output types
+// =============================================================================
+/**
+ * A pass-through schema: it validates nothing and has no JSON Schema. The type parameter only
+ * gives the TypeScript type.
+ *
+ * Use it for internal procedures where a real schema adds nothing. A procedure that an MCP
+ * server exposes, or that a user calls from the CLI, takes a real schema (zod), so its input
+ * is validated and its tools and help describe the fields (roadmap 2.1).
+ */
+export function outputSchema() {
+    return {
+        parse: (data) => data,
+        safeParse: (data) => ({ success: true, data: data }),
+        _output: undefined,
+        "~standard": passThrough(),
+    };
+}
+//# sourceMappingURL=schemas.js.map

package/dist/procedures/core/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/procedures/core/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAA0C,MAAM,cAAc,CAAC;AAexF,qFAAqF;AACrF,SAAS,WAAW;IAClB,OAAO;QACL,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,oBAAoB;QAC5B,QAAQ,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAU,EAAE,CAAC;KACtD,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,uCAAuC;AACvC,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAA2F;IAC/G,KAAK,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK;IAChC,SAAS,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC/D,WAAW,EAAE,WAAW,EAAO;IAC/B,aAAa,EAAE,EAAE;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,KAAK,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,KAAU;QACrC,SAAS,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAU,EAAE,CAAC;QACpE,WAAW,EAAE,WAAW,EAAK;KAC9B,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,4DAA4D;AAC5D,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAI,MAAuC;IACnE,IAAI,gBAAgB,CAAC,MAAM,CAAC,IAAI,OAAQ,MAAkC,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACpG,OAAO,MAAqC,CAAC;IAC/C,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,IAAa,EAAwE,EAAE;QACxG,IAAI,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAA+F,CAAC;YAC5G,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,mBAAmB,CAAC;YACnD,4DAA4D;YAC5D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;YACxC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9G,CAAC;IACH,CAAC,CAAC;IACF,OAAO;QACL,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAC5C,SAAS;QACT,OAAO,EAAE,SAAyB;QAClC,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,oBAAoB;YAC5B,QAAQ,EAAE,CAAC,KAAc,EAAE,EAAE;gBAC3B,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;gBAChC,OAAO,MAAM,CAAC,OAAO;oBACnB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE;oBACxB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAC7G,CAAC;SACF;KACkB,CAAC;AACxB,CAAC;AAED,gFAAgF;AAChF,uDAAuD;AACvD,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,IAAS;QACnC,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,IAAI,EAAE,IAAS,EAAE,CAAC;QAC3E,OAAO,EAAE,SAAyB;QAClC,WAAW,EAAE,WAAW,EAAK;KAC9B,CAAC;AACJ,CAAC"}

package/dist/procedures/core/string.d.ts

@@ -0,0 +1,138 @@
+/**
+ * String Procedures
+ *
+ * String manipulation operations for procedure aggregation.
+ * All procedures are namespaced under "client" (e.g., client.concat, client.split).
+ */
+import type { AnyProcedure, Procedure } from "../types.js";
+interface ConcatInput {
+    values: string[];
+    separator?: string | undefined;
+}
+type ConcatProcedure = Procedure<ConcatInput, string, {
+    description: string;
+    tags: string[];
+}>;
+declare const concatProcedure: ConcatProcedure;
+interface SplitInput {
+    value: string;
+    separator: string;
+    limit?: number | undefined;
+}
+type SplitProcedure = Procedure<SplitInput, string[], {
+    description: string;
+    tags: string[];
+}>;
+declare const splitProcedure: SplitProcedure;
+interface JoinInput {
+    values: string[];
+    separator: string;
+}
+type JoinProcedure = Procedure<JoinInput, string, {
+    description: string;
+    tags: string[];
+}>;
+declare const joinProcedure: JoinProcedure;
+interface ReplaceInput {
+    value: string;
+    search: string;
+    replace: string;
+    all?: boolean | undefined;
+}
+type ReplaceProcedure = Procedure<ReplaceInput, string, {
+    description: string;
+    tags: string[];
+}>;
+declare const replaceProcedure: ReplaceProcedure;
+interface SubstringInput {
+    value: string;
+    start: number;
+    end?: number | undefined;
+}
+type SubstringProcedure = Procedure<SubstringInput, string, {
+    description: string;
+    tags: string[];
+}>;
+declare const substringProcedure: SubstringProcedure;
+interface TrimInput {
+    value: string;
+    side?: "start" | "end" | "both" | undefined;
+}
+type TrimProcedure = Procedure<TrimInput, string, {
+    description: string;
+    tags: string[];
+}>;
+declare const trimProcedure: TrimProcedure;
+interface ToLowerInput {
+    value: string;
+}
+type ToLowerProcedure = Procedure<ToLowerInput, string, {
+    description: string;
+    tags: string[];
+}>;
+declare const toLowerProcedure: ToLowerProcedure;
+interface ToUpperInput {
+    value: string;
+}
+type ToUpperProcedure = Procedure<ToUpperInput, string, {
+    description: string;
+    tags: string[];
+}>;
+declare const toUpperProcedure: ToUpperProcedure;
+interface StartsWithInput {
+    value: string;
+    search: string;
+}
+type StartsWithProcedure = Procedure<StartsWithInput, boolean, {
+    description: string;
+    tags: string[];
+}>;
+declare const startsWithProcedure: StartsWithProcedure;
+interface EndsWithInput {
+    value: string;
+    search: string;
+}
+type EndsWithProcedure = Procedure<EndsWithInput, boolean, {
+    description: string;
+    tags: string[];
+}>;
+declare const endsWithProcedure: EndsWithProcedure;
+interface IncludesInput {
+    value: string;
+    search: string;
+}
+type IncludesProcedure = Procedure<IncludesInput, boolean, {
+    description: string;
+    tags: string[];
+}>;
+declare const includesProcedure: IncludesProcedure;
+interface StrLengthInput {
+    value: string;
+}
+type StrLengthProcedure = Procedure<StrLengthInput, number, {
+    description: string;
+    tags: string[];
+}>;
+declare const strLengthProcedure: StrLengthProcedure;
+interface TemplateInput {
+    template: string;
+    values: Record<string, unknown>;
+}
+type TemplateProcedure = Procedure<TemplateInput, string, {
+    description: string;
+    tags: string[];
+}>;
+declare const templateProcedure: TemplateProcedure;
+/**
+ * All string procedures namespaced under "client".
+ */
+export declare const stringProcedures: AnyProcedure[];
+/**
+ * String procedures module for registration.
+ */
+export declare const stringModule: {
+    name: string;
+    procedures: AnyProcedure[];
+};
+export { concatProcedure, splitProcedure, joinProcedure, replaceProcedure, substringProcedure, trimProcedure, toLowerProcedure, toUpperProcedure, startsWithProcedure, endsWithProcedure, includesProcedure, strLengthProcedure, templateProcedure, };
+//# sourceMappingURL=string.d.ts.map

package/dist/procedures/core/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../../src/procedures/core/string.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM3D,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAOD,KAAK,eAAe,GAAG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAE/F,QAAA,MAAM,eAAe,EAAE,eAWrB,CAAC;AAMH,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAQD,KAAK,cAAc,GAAG,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAE/F,QAAA,MAAM,cAAc,EAAE,cAWpB,CAAC;AAMH,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,KAAK,aAAa,GAAG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAE3F,QAAA,MAAM,aAAa,EAAE,aAWnB,CAAC;AAMH,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3B;AASD,KAAK,gBAAgB,GAAG,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAEjG,QAAA,MAAM,gBAAgB,EAAE,gBActB,CAAC;AAMH,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAQD,KAAK,kBAAkB,GAAG,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAErG,QAAA,MAAM,kBAAkB,EAAE,kBAWxB,CAAC;AAMH,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7C;AAOD,KAAK,aAAa,GAAG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAE3F,QAAA,MAAM,aAAa,EAAE,aAmBnB,CAAC;AAMH,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,KAAK,gBAAgB,GAAG,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAEjG,QAAA,MAAM,gBAAgB,EAAE,gBAWtB,CAAC;AAMH,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,KAAK,gBAAgB,GAAG,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAEjG,QAAA,MAAM,gBAAgB,EAAE,gBAWtB,CAAC;AAMH,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAOD,KAAK,mBAAmB,GAAG,SAAS,CAAC,eAAe,EAAE,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAExG,QAAA,MAAM,mBAAmB,EAAE,mBAWzB,CAAC;AAMH,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAOD,KAAK,iBAAiB,GAAG,SAAS,CAAC,aAAa,EAAE,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAEpG,QAAA,MAAM,iBAAiB,EAAE,iBAWvB,CAAC;AAMH,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAOD,KAAK,iBAAiB,GAAG,SAAS,CAAC,aAAa,EAAE,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAEpG,QAAA,MAAM,iBAAiB,EAAE,iBAWvB,CAAC;AAMH,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,KAAK,kBAAkB,GAAG,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAErG,QAAA,MAAM,kBAAkB,EAAE,kBAWxB,CAAC;AAMH,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAOD,KAAK,iBAAiB,GAAG,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAEnG,QAAA,MAAM,iBAAiB,EAAE,iBAevB,CAAC;AAyBH;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAAY,EAA+C,CAAC;AAE3F;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,YAAY,EAAE,CAAA;CAGpE,CAAC;AAGF,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,CAAC"}