@pikku/addon-graph 0.0.1

package/dist/.pikku/workflow/pikku-workflow-types.gen.ts

@@ -0,0 +1,158 @@
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */
+import { WorkflowCancelledException } from '@pikku/core/workflow'
+import {
+  workflow as coreWorkflow,
+  workflowStart as coreWorkflowStart,
+  workflowStatus as coreWorkflowStatus,
+  graphStart as coreGraphStart,
+} from '@pikku/core/workflow'
+import { template } from '@pikku/core/workflow'
+import {
+  pikkuWorkflowGraph as corePikkuWorkflowGraph,
+  type PikkuWorkflowGraphConfig,
+  type PikkuWorkflowGraphResult,
+} from '@pikku/core/workflow'
+import type { PikkuWorkflowWire, WorkflowStepOptions } from '@pikku/core/workflow'
+
+export { WorkflowCancelledException }
+import type { PikkuFunctionSessionless, PikkuFunctionConfig } from '../function/pikku-function-types.gen.js'
+import type { RPCMap, FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js'
+import type { WorkflowMap, GraphsMap } from './pikku-workflow-map.gen.d.js'
+
+export { template }
+
+export interface TypedWorkflow extends PikkuWorkflowWire {
+  do<K extends keyof RPCMap>(
+    stepName: string,
+    rpcName: K,
+    data: RPCMap[K]['input'],
+    options?: WorkflowStepOptions
+  ): Promise<RPCMap[K]['output']>
+
+  do<T>(
+    stepName: string,
+    fn: () => T | Promise<T>,
+    options?: WorkflowStepOptions
+  ): Promise<T>
+}
+
+export type PikkuFunctionWorkflow<
+  In = unknown,
+  Out = never
+> = PikkuFunctionSessionless<In, Out, 'workflow'>
+
+export const pikkuWorkflowFunc = <In, Out = unknown>(
+  func:
+    | PikkuFunctionWorkflow<In, Out>
+    | PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>
+) => {
+  return typeof func === 'function' ? { func } : func
+}
+
+export const pikkuWorkflowComplexFunc = <In, Out = unknown>(
+  func:
+    | PikkuFunctionWorkflow<In, Out>
+    | PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>
+) => {
+  return typeof func === 'function' ? { func } : func
+}
+
+type TypedRef<T> = { $ref: string; path?: string } & { __phantomType?: T }
+
+type TemplateString = {
+  $template: {
+    parts: string[]
+    expressions: Array<{ $ref: string; path?: string }>
+  }
+} & { __brand: 'TemplateString' }
+
+type InputWithRefs<T> = {
+  [K in keyof T]?: T[K] | TypedRef<T[K]> | TypedRef<unknown> | TemplateString
+}
+
+type NodeInputType<FuncMap extends Record<string, string>, K extends keyof FuncMap> =
+  FuncMap[K] extends keyof FlattenedRPCMap
+    ? InputWithRefs<FlattenedRPCMap[FuncMap[K]]['input']>
+    : Record<string, unknown>
+
+type NodeOutputKeys<FuncMap extends Record<string, string>, N extends string> =
+  N extends keyof FuncMap
+    ? FuncMap[N] extends keyof FlattenedRPCMap
+      ? keyof FlattenedRPCMap[FuncMap[N]]['output'] & string
+      : string
+    : string
+
+type RefFunction<FuncMap extends Record<string, string>> = {
+  <N extends Extract<keyof FuncMap, string>>(
+    nodeId: N,
+    path: NodeOutputKeys<FuncMap, N>
+  ): TypedRef<unknown>
+  (nodeId: 'trigger' | '$item', path?: string): TypedRef<unknown>
+}
+
+type TemplateFunction = (templateStr: string, refs: TypedRef<unknown>[]) => TemplateString
+
+type GraphNodeConfigMap<FuncMap extends Record<string, string>> = {
+  [K in Extract<keyof FuncMap, string>]?: {
+    next?: NextConfig<Extract<keyof FuncMap, string>>
+    input?:
+      | NodeInputType<FuncMap, K>
+      | (() => NodeInputType<FuncMap, K>)
+      | ((ref: RefFunction<FuncMap>, template: TemplateFunction) => NodeInputType<FuncMap, K>)
+    onError?: Extract<keyof FuncMap, string> | Extract<keyof FuncMap, string>[]
+  }
+}
+
+type NextConfig<NodeIds extends string> = NodeIds | NodeIds[] | { if: string; then: NodeIds; else?: NodeIds }
+
+export function pikkuWorkflowGraph<
+  const FuncMap extends Record<string, keyof FlattenedRPCMap & string>
+>(
+  config: PikkuWorkflowGraphConfig<FuncMap, GraphNodeConfigMap<FuncMap>>
+): PikkuWorkflowGraphResult {
+  return corePikkuWorkflowGraph(config as any)
+}
+
+export const workflow = <Name extends keyof WorkflowMap>(
+  workflowName: Name,
+  options?: { pollIntervalMs?: number }
+) => {
+  return coreWorkflow<WorkflowMap>(workflowName as string & keyof WorkflowMap, options) as PikkuFunctionConfig<
+    WorkflowMap[Name]['input'],
+    WorkflowMap[Name]['output'],
+    'session' | 'rpc'
+  >
+}
+
+export const workflowStart = <Name extends keyof WorkflowMap>(
+  workflowName: Name
+) => {
+  return coreWorkflowStart<WorkflowMap>(workflowName as string & keyof WorkflowMap) as PikkuFunctionConfig<
+    WorkflowMap[Name]['input'],
+    { runId: string },
+    'session' | 'rpc'
+  >
+}
+
+export const workflowStatus = <Name extends keyof WorkflowMap>(
+  _workflowName: Name
+) => {
+  return coreWorkflowStatus<WorkflowMap>(_workflowName as string & keyof WorkflowMap) as PikkuFunctionConfig<
+    { runId: string },
+    { id: string; status: 'running' | 'completed' | 'failed' | 'cancelled'; output?: WorkflowMap[Name]['output']; error?: { message?: string } },
+    'session' | 'rpc'
+  >
+}
+
+export const graphStart = <Name extends keyof GraphsMap, Node extends string & keyof GraphsMap[Name]>(
+  graphName: Name,
+  startNode: Node
+) => {
+  return coreGraphStart<GraphsMap>(graphName as string & keyof GraphsMap, startNode as string) as PikkuFunctionConfig<
+    GraphsMap[Name][Node] extends { input: infer I } ? I : never,
+    { runId: string },
+    'session' | 'rpc'
+  >
+}

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pikku-workflow-wirings-meta.gen.d.ts.map

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-workflow-wirings-meta.gen.d.ts","sourceRoot":"","sources":["../../../.pikku/workflow/pikku-workflow-wirings-meta.gen.ts"],"names":[],"mappings":""}

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.js

@@ -0,0 +1,7 @@
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */
+import { pikkuState } from '@pikku/core/internal';
+const workflowsMeta = {};
+pikkuState('@pikku/addon-graph', 'workflows', 'meta', workflowsMeta);
+//# sourceMappingURL=pikku-workflow-wirings-meta.gen.js.map

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-workflow-wirings-meta.gen.js","sourceRoot":"","sources":["../../../.pikku/workflow/pikku-workflow-wirings-meta.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAGjD,MAAM,aAAa,GAA6B,EAAE,CAAA;AAElD,UAAU,CAAC,oBAAoB,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,CAAA"}

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */
+import { pikkuState } from '@pikku/core/internal'
+import type { SerializedWorkflowGraphs } from '@pikku/inspector/workflow-graph'
+
+const workflowsMeta: SerializedWorkflowGraphs = {}
+
+pikkuState('@pikku/addon-graph', 'workflows', 'meta', workflowsMeta)

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.d.ts

@@ -0,0 +1,5 @@
+export {};
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */
+//# sourceMappingURL=pikku-workflow-wirings.gen.d.ts.map

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-workflow-wirings.gen.d.ts","sourceRoot":"","sources":["../../../.pikku/workflow/pikku-workflow-wirings.gen.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.js

@@ -0,0 +1,5 @@
+export {};
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */
+//# sourceMappingURL=pikku-workflow-wirings.gen.js.map

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-workflow-wirings.gen.js","sourceRoot":"","sources":["../../../.pikku/workflow/pikku-workflow-wirings.gen.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.ts

@@ -0,0 +1,3 @@
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */

package/dist/src/functions/array/aggregate.function.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+export declare const AggregateInput: z.ZodObject<{
+    items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    field: z.ZodString;
+    outputField: z.ZodOptional<z.ZodString>;
+    unique: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const AggregateOutput: z.ZodObject<{
+    item: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const aggregate: import("#pikku").PikkuFunctionConfig<{
+    items: Record<string, unknown>[];
+    field: string;
+    outputField?: string | undefined;
+    unique?: boolean | undefined;
+}, {
+    item: Record<string, unknown>;
+}, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+    items: Record<string, unknown>[];
+    field: string;
+    outputField?: string | undefined;
+    unique?: boolean | undefined;
+}, {
+    item: Record<string, unknown>;
+}, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+    items: Record<string, unknown>[];
+    field: string;
+    outputField?: string | undefined;
+    unique?: boolean | undefined;
+}, {
+    item: Record<string, unknown>;
+}, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+//# sourceMappingURL=aggregate.function.d.ts.map

package/dist/src/functions/array/aggregate.function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.function.d.ts","sourceRoot":"","sources":["../../../../src/functions/array/aggregate.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,cAAc;;;;;iBAUzB,CAAA;AAEF,eAAO,MAAM,eAAe;;iBAI1B,CAAA;AAiBF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;uEAsBpB,CAAA"}

package/dist/src/functions/array/aggregate.function.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '#pikku';
+export const AggregateInput = z.object({
+    items: z
+        .array(z.record(z.string(), z.unknown()))
+        .describe('The array of items to aggregate'),
+    field: z.string().describe('The field path to collect values from'),
+    outputField: z
+        .string()
+        .optional()
+        .describe('The name of the output field containing the list'),
+    unique: z.boolean().optional().describe('Only include unique values'),
+});
+export const AggregateOutput = z.object({
+    item: z
+        .record(z.string(), z.unknown())
+        .describe('The output object with aggregated values'),
+});
+const getNestedValue = (obj, path) => {
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || typeof current !== 'object')
+            return undefined;
+        current = current[key];
+    }
+    return current;
+};
+export const aggregate = pikkuSessionlessFunc({
+    description: 'Combine a field from many items into a list in a single item',
+    node: { displayName: 'Aggregate', category: 'Array', type: 'action' },
+    input: AggregateInput,
+    output: AggregateOutput,
+    func: async (_services, data) => {
+        const outputField = data.outputField ?? 'aggregated';
+        const unique = data.unique ?? false;
+        let values = data.items.map((item) => getNestedValue(item, data.field));
+        if (unique) {
+            const seen = new Set();
+            values = values.filter((v) => {
+                const key = JSON.stringify(v);
+                if (seen.has(key))
+                    return false;
+                seen.add(key);
+                return true;
+            });
+        }
+        return { item: { [outputField]: values } };
+    },
+});
+//# sourceMappingURL=aggregate.function.js.map

package/dist/src/functions/array/aggregate.function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.function.js","sourceRoot":"","sources":["../../../../src/functions/array/aggregate.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAE7C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SACxC,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACnE,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CACtE,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,CAAC,0CAA0C,CAAC;CACxD,CAAC,CAAA;AAIF,MAAM,cAAc,GAAG,CACrB,GAA4B,EAC5B,IAAY,EACH,EAAE;IACX,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5B,IAAI,OAAO,GAAY,GAAG,CAAA;IAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAA;QACrE,OAAO,GAAI,OAAmC,CAAC,GAAG,CAAC,CAAA;IACrD,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,oBAAoB,CAAC;IAC5C,WAAW,EAAE,8DAA8D;IAC3E,IAAI,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;IACrE,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,eAAe;IACvB,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,YAAY,CAAA;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAA;QACnC,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QAEvE,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;YAC9B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;gBAC7B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,OAAO,KAAK,CAAA;gBAC/B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;gBACb,OAAO,IAAI,CAAA;YACb,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,CAAA;IAC5C,CAAC;CACF,CAAC,CAAA"}

package/dist/src/functions/array/chunk.function.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export declare const ChunkInput: z.ZodObject<{
+    items: z.ZodArray<z.ZodUnknown>;
+    size: z.ZodNumber;
+}, z.core.$strip>;
+export declare const ChunkOutput: z.ZodObject<{
+    chunks: z.ZodArray<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const chunk: import("#pikku").PikkuFunctionConfig<{
+    items: unknown[];
+    size: number;
+}, {
+    chunks: unknown[][];
+}, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+    items: unknown[];
+    size: number;
+}, {
+    chunks: unknown[][];
+}, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+    items: unknown[];
+    size: number;
+}, {
+    chunks: unknown[][];
+}, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+//# sourceMappingURL=chunk.function.d.ts.map

package/dist/src/functions/array/chunk.function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.function.d.ts","sourceRoot":"","sources":["../../../../src/functions/array/chunk.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,UAAU;;;iBAGrB,CAAA;AAEF,eAAO,MAAM,WAAW;;iBAEtB,CAAA;AAIF,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;uEAchB,CAAA"}

package/dist/src/functions/array/chunk.function.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '#pikku';
+export const ChunkInput = z.object({
+    items: z.array(z.unknown()).describe('The array to split into chunks'),
+    size: z.number().min(1).describe('Size of each chunk'),
+});
+export const ChunkOutput = z.object({
+    chunks: z.array(z.array(z.unknown())).describe('Array of chunks'),
+});
+export const chunk = pikkuSessionlessFunc({
+    description: 'Split array into chunks of specified size',
+    node: { displayName: 'Chunk', category: 'Array', type: 'action' },
+    input: ChunkInput,
+    output: ChunkOutput,
+    func: async (_services, data) => {
+        const chunks = [];
+        for (let i = 0; i < data.items.length; i += data.size) {
+            chunks.push(data.items.slice(i, i + data.size));
+        }
+        return { chunks };
+    },
+});
+//# sourceMappingURL=chunk.function.js.map

package/dist/src/functions/array/chunk.function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.function.js","sourceRoot":"","sources":["../../../../src/functions/array/chunk.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAE7C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACtE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CACvD,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;CAClE,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,KAAK,GAAG,oBAAoB,CAAC;IACxC,WAAW,EAAE,2CAA2C;IACxD,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;IACjE,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAgB,EAAE,CAAA;QAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACjD,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,CAAA;IACnB,CAAC;CACF,CAAC,CAAA"}

package/dist/src/functions/array/find.function.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export declare const FindInput: z.ZodObject<{
+    items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    field: z.ZodString;
+    value: z.ZodUnknown;
+    returnIndex: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const FindOutput: z.ZodObject<{
+    item: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    index: z.ZodNumber;
+    found: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const find: import("#pikku").PikkuFunctionConfig<{
+    items: Record<string, unknown>[];
+    field: string;
+    value: unknown;
+    returnIndex?: boolean | undefined;
+}, {
+    item: Record<string, unknown> | null;
+    index: number;
+    found: boolean;
+}, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+    items: Record<string, unknown>[];
+    field: string;
+    value: unknown;
+    returnIndex?: boolean | undefined;
+}, {
+    item: Record<string, unknown> | null;
+    index: number;
+    found: boolean;
+}, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+    items: Record<string, unknown>[];
+    field: string;
+    value: unknown;
+    returnIndex?: boolean | undefined;
+}, {
+    item: Record<string, unknown> | null;
+    index: number;
+    found: boolean;
+}, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+//# sourceMappingURL=find.function.d.ts.map

package/dist/src/functions/array/find.function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.function.d.ts","sourceRoot":"","sources":["../../../../src/functions/array/find.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,SAAS;;;;;iBAUpB,CAAA;AAEF,eAAO,MAAM,UAAU;;;;iBAOrB,CAAA;AAiBF,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;uEAyBf,CAAA"}

package/dist/src/functions/array/find.function.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '#pikku';
+export const FindInput = z.object({
+    items: z
+        .array(z.record(z.string(), z.unknown()))
+        .describe('The array to search'),
+    field: z.string().describe('The field to match against'),
+    value: z.unknown().describe('The value to find'),
+    returnIndex: z
+        .boolean()
+        .optional()
+        .describe('Return the index instead of the item'),
+});
+export const FindOutput = z.object({
+    item: z
+        .record(z.string(), z.unknown())
+        .nullable()
+        .describe('The found item (null if not found)'),
+    index: z.number().describe('The index of the found item (-1 if not found)'),
+    found: z.boolean().describe('Whether the item was found'),
+});
+const getNestedValue = (obj, path) => {
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || typeof current !== 'object')
+            return undefined;
+        current = current[key];
+    }
+    return current;
+};
+export const find = pikkuSessionlessFunc({
+    description: 'Find the first item matching a field value',
+    node: { displayName: 'Find', category: 'Array', type: 'action' },
+    input: FindInput,
+    output: FindOutput,
+    func: async (_services, data) => {
+        const targetStr = JSON.stringify(data.value);
+        for (let i = 0; i < data.items.length; i++) {
+            const itemValue = getNestedValue(data.items[i], data.field);
+            if (JSON.stringify(itemValue) === targetStr) {
+                return {
+                    item: data.items[i],
+                    index: i,
+                    found: true,
+                };
+            }
+        }
+        return {
+            item: null,
+            index: -1,
+            found: false,
+        };
+    },
+});
+//# sourceMappingURL=find.function.js.map

package/dist/src/functions/array/find.function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.function.js","sourceRoot":"","sources":["../../../../src/functions/array/find.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAE7C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SACxC,QAAQ,CAAC,qBAAqB,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACxD,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAChD,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,sCAAsC,CAAC;CACpD,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC3E,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CAC1D,CAAC,CAAA;AAIF,MAAM,cAAc,GAAG,CACrB,GAA4B,EAC5B,IAAY,EACH,EAAE;IACX,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5B,IAAI,OAAO,GAAY,GAAG,CAAA;IAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAA;QACrE,OAAO,GAAI,OAAmC,CAAC,GAAG,CAAC,CAAA;IACrD,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,oBAAoB,CAAC;IACvC,WAAW,EAAE,4CAA4C;IACzD,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;IAChE,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAE5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;YAC3D,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC5C,OAAO;oBACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;oBACnB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,IAAI;iBACZ,CAAA;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,CAAC,CAAC;YACT,KAAK,EAAE,KAAK;SACb,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/src/functions/array/group-by.function.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export declare const GroupByInput: z.ZodObject<{
+    items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    field: z.ZodString;
+}, z.core.$strip>;
+export declare const GroupByOutput: z.ZodObject<{
+    groups: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export declare const groupBy: import("#pikku").PikkuFunctionConfig<{
+    items: Record<string, unknown>[];
+    field: string;
+}, {
+    groups: Record<string, Record<string, unknown>[]>;
+}, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+    items: Record<string, unknown>[];
+    field: string;
+}, {
+    groups: Record<string, Record<string, unknown>[]>;
+}, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+    items: Record<string, unknown>[];
+    field: string;
+}, {
+    groups: Record<string, Record<string, unknown>[]>;
+}, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+//# sourceMappingURL=group-by.function.d.ts.map

package/dist/src/functions/array/group-by.function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by.function.d.ts","sourceRoot":"","sources":["../../../../src/functions/array/group-by.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,YAAY;;;iBAKvB,CAAA;AAEF,eAAO,MAAM,aAAa;;iBAIxB,CAAA;AAiBF,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;uEAoBlB,CAAA"}

package/dist/src/functions/array/group-by.function.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '#pikku';
+export const GroupByInput = z.object({
+    items: z
+        .array(z.record(z.string(), z.unknown()))
+        .describe('The array of items to group'),
+    field: z.string().describe('The field to group by (supports dot notation)'),
+});
+export const GroupByOutput = z.object({
+    groups: z
+        .record(z.string(), z.array(z.record(z.string(), z.unknown())))
+        .describe('Object with group keys and their items'),
+});
+const getNestedValue = (obj, path) => {
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || typeof current !== 'object')
+            return undefined;
+        current = current[key];
+    }
+    return current;
+};
+export const groupBy = pikkuSessionlessFunc({
+    description: 'Group items by a field value',
+    node: { displayName: 'Group By', category: 'Array', type: 'action' },
+    input: GroupByInput,
+    output: GroupByOutput,
+    func: async (_services, data) => {
+        const groups = {};
+        for (const item of data.items) {
+            const value = getNestedValue(item, data.field);
+            const key = String(value ?? 'undefined');
+            if (!groups[key]) {
+                groups[key] = [];
+            }
+            groups[key].push(item);
+        }
+        return { groups };
+    },
+});
+//# sourceMappingURL=group-by.function.js.map

package/dist/src/functions/array/group-by.function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by.function.js","sourceRoot":"","sources":["../../../../src/functions/array/group-by.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SACxC,QAAQ,CAAC,6BAA6B,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;CAC5E,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;SAC9D,QAAQ,CAAC,wCAAwC,CAAC;CACtD,CAAC,CAAA;AAIF,MAAM,cAAc,GAAG,CACrB,GAA4B,EAC5B,IAAY,EACH,EAAE;IACX,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5B,IAAI,OAAO,GAAY,GAAG,CAAA;IAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAA;QACrE,OAAO,GAAI,OAAmC,CAAC,GAAG,CAAC,CAAA;IACrD,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,oBAAoB,CAAC;IAC1C,WAAW,EAAE,8BAA8B;IAC3C,IAAI,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;IACpE,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,aAAa;IACrB,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,MAAM,GAA8C,EAAE,CAAA;QAE5D,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;YAC9C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,WAAW,CAAC,CAAA;YAExC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;YAClB,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACxB,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,CAAA;IACnB,CAAC;CACF,CAAC,CAAA"}

package/dist/src/functions/array/limit.function.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+export declare const LimitInput: z.ZodObject<{
+    items: z.ZodArray<z.ZodUnknown>;
+    limit: z.ZodNumber;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const LimitOutput: z.ZodObject<{
+    items: z.ZodArray<z.ZodUnknown>;
+    totalCount: z.ZodNumber;
+}, z.core.$strip>;
+export declare const limit: import("#pikku").PikkuFunctionConfig<{
+    items: unknown[];
+    limit: number;
+    offset?: number | undefined;
+}, {
+    items: unknown[];
+    totalCount: number;
+}, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+    items: unknown[];
+    limit: number;
+    offset?: number | undefined;
+}, {
+    items: unknown[];
+    totalCount: number;
+}, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+    items: unknown[];
+    limit: number;
+    offset?: number | undefined;
+}, {
+    items: unknown[];
+    totalCount: number;
+}, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+//# sourceMappingURL=limit.function.d.ts.map

package/dist/src/functions/array/limit.function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limit.function.d.ts","sourceRoot":"","sources":["../../../../src/functions/array/limit.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,UAAU;;;;iBAQrB,CAAA;AAEF,eAAO,MAAM,WAAW;;;iBAGtB,CAAA;AAIF,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;uEAWhB,CAAA"}

package/dist/src/functions/array/limit.function.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '#pikku';
+export const LimitInput = z.object({
+    items: z.array(z.unknown()).describe('The array of items to limit'),
+    limit: z.number().min(0).describe('Maximum number of items to return'),
+    offset: z
+        .number()
+        .min(0)
+        .optional()
+        .describe('Number of items to skip from the beginning'),
+});
+export const LimitOutput = z.object({
+    items: z.array(z.unknown()).describe('The limited array of items'),
+    totalCount: z.number().describe('The original total count before limiting'),
+});
+export const limit = pikkuSessionlessFunc({
+    description: 'Restrict the number of items',
+    node: { displayName: 'Limit', category: 'Array', type: 'action' },
+    input: LimitInput,
+    output: LimitOutput,
+    func: async (_services, data) => {
+        const offset = data.offset ?? 0;
+        const totalCount = data.items.length;
+        const items = data.items.slice(offset, offset + data.limit);
+        return { items, totalCount };
+    },
+});
+//# sourceMappingURL=limit.function.js.map

package/dist/src/functions/array/limit.function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limit.function.js","sourceRoot":"","sources":["../../../../src/functions/array/limit.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAE7C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACnE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACtE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;CAC1D,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAClE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CAC5E,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,KAAK,GAAG,oBAAoB,CAAC;IACxC,WAAW,EAAE,8BAA8B;IAC3C,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;IACjE,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAA;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3D,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;IAC9B,CAAC;CACF,CAAC,CAAA"}