@hotmeshio/hotmesh 0.4.0 → 0.4.1

package/types/meshcall.ts

@@ -1,235 +0,0 @@
-import { ProviderConfig, ProvidersConfig } from './provider';
-import { LogLevel } from './logger';
-
-interface MeshCallExecOptions {
-  /**
-   * Cache id when caching, flushing and retrieving function results.
-   */
-  id: string;
-  /**
-   * Time to live for the cache key. For example, `1 day`, `1 hour`. Refer to the syntax for the `ms` NPM package.
-   */
-  ttl?: string;
-  /**
-   * If true, the cache will first be flushed and the function will be executed.
-   */
-  flush?: boolean;
-}
-interface MeshCallConnectParams {
-  /**
-   * Log level for the worker
-   */
-  logLevel?: LogLevel;
-  /**
-   * Idempotent GUID for the worker and engine
-   */
-  guid?: string;
-  /**
-   * Namespace for grouping common functions
-   */
-  namespace?: string;
-  /**
-   * Unique topic for the worker function
-   */
-  topic: string;
-  /**
-   * Redis configuration; use 'connection' instead of 'redis'
-   * @deprecated
-   */
-  redis?: ProviderConfig;
-  /**
-   * Provider configuration
-   */
-  connection?: ProviderConfig | ProvidersConfig;
-  /**
-   * The linked worker function that will be called; optional if read only
-   */
-  callback?: (...args: any[]) => any;
-}
-
-interface MeshCallExecParams {
-  /**
-   * namespace for grouping common functions
-   */
-  namespace?: string;
-  /**
-   * topic assigned to the worker when it was connected
-   */
-  topic: string;
-  /**
-   * Arguments to pass to the worker function
-   */
-  args: any[];
-  /**
-   * Redis configuration; use 'connection' instead of 'redis'
-   * @deprecated
-   */
-  redis?: ProviderConfig;
-  /**
-   * Provider configuration
-   */
-  connection?: ProviderConfig | ProvidersConfig;
-  /**
-   * Execution options like caching ttl
-   */
-  options?: MeshCallExecOptions;
-}
-
-interface MeshCallFlushOptions {
-  /**
-   * Cache id when caching/flushing/retrieving function results.
-   */
-  id: string;
-}
-
-interface MeshCallFlushParams {
-  /**
-   * namespace for grouping common functions
-   */
-  namespace?: string;
-  /**
-   * id for cached response to flush
-   */
-  id?: string;
-  /**
-   * topic assigned to the worker when it was connected
-   */
-  topic: string;
-  /**
-   * Redis configuration; use 'connection' instead of 'redis'
-   * @deprecated
-   */
-  redis?: ProviderConfig;
-  /**
-   * Provider configuration
-   */
-  connection?: ProviderConfig | ProvidersConfig;
-  /**
-   * Options for the flush
-   */
-  options?: MeshCallFlushOptions;
-}
-interface MeshCallCronOptions {
-  /**
-   * Idempotent GUID for the function
-   * */
-  id: string;
-  /**
-   * For example, `1 day`, `1 hour`. Fidelity is generally
-   * within 5 seconds. Refer to the syntax for the `ms` NPM package.
-   * Standard cron syntax is also supported. (e.g. `0 0 * * *`)
-   */
-  interval: string;
-  /**
-   * Maximum number of cycles to run before exiting the cron.
-   */
-  maxCycles?: number;
-  /**
-   * Time in seconds to sleep before invoking the first cycle.
-   * For example, `1 day`, `1 hour`. Fidelity is generally
-   * within 5 seconds. Refer to the syntax for the `ms` NPM package.
-   * If the interval field uses standard cron syntax, this field is ignored.
-   */
-  delay?: string;
-}
-
-interface MeshCallInterruptOptions {
-  /**
-   * Idempotent GUID for the cron function
-   */
-  id: string;
-}
-
-interface MeshCallCronParams {
-  /**
-   * Log level for the cron
-   */
-  logLevel?: LogLevel;
-  /**
-   * Idempotent GUID for the worker and engine used for the cron
-   */
-  guid?: string;
-  /**
-   * Namespace for grouping common cron functions. (e.g. `hmsh:[namespace]:j:*`)
-   */
-  namespace?: string;
-  /**
-   * Unique topic for the cron function to identify the worker
-   */
-  topic: string;
-  /**
-   * Redis configuration; use 'connection' instead of 'redis'
-   * @deprecated
-   */
-  redis?: ProviderConfig;
-  /**
-   * Provider configuration
-   */
-  connection?: ProviderConfig | ProvidersConfig;
-  /**
-   * Arguments to pass to the cron job; arguments will be passed to the callback
-   * each time it runs
-   */
-  args: any[];
-  /**
-   * linked worker function to run; if not provided, the system will
-   * attempt to start the cron job using the topic, but a new
-   * worker will not be created. This is useful for spawning a cron job
-   * from an ephemeral node process.
-   */
-  callback?: (...args: any[]) => any;
-  /**
-   * Options for the cron job
-   */
-  options: MeshCallCronOptions;
-}
-
-interface MeshCallInstanceOptions {
-  /**
-   * if true, the connection to HotMesh will be in readonly mode
-   * and the instantiated client will not route messages
-   * @default false
-   */
-  readonly?: boolean;
-  /**
-   * Idempotent GUID for the worker and engine
-   */
-  guid?: string;
-}
-
-interface MeshCallInterruptParams {
-  /**
-   * namespace for grouping common functions
-   */
-  namespace?: string;
-  /**
-   * topic assigned to the cron worker when it was connected
-   */
-  topic: string;
-  /**
-   * Redis configuration; use 'connection' instead of 'redis'
-   * @deprecated
-   */
-  redis?: ProviderConfig;
-  /**
-   * Provider configuration
-   */
-  connection?: ProviderConfig | ProvidersConfig;
-  /**
-   * Options for interrupting the cron
-   */
-  options: MeshCallInterruptOptions;
-}
-
-export {
-  MeshCallConnectParams,
-  MeshCallExecParams,
-  MeshCallCronParams,
-  MeshCallExecOptions,
-  MeshCallCronOptions,
-  MeshCallInterruptOptions,
-  MeshCallInterruptParams,
-  MeshCallFlushOptions,
-  MeshCallFlushParams,
-  MeshCallInstanceOptions,
-};

package/types/meshdata.ts

@@ -1,278 +0,0 @@
-import { HookOptions, WorkflowConfig, WorkflowSearchOptions } from './memflow';
-import { StringStringType } from './serializer';
-
-export type CallOptions = {
-  /**
-   * if provided along with a `ttl`, the function will be cached
-   */
-  id?: string;
-  /**
-   * in format '1 minute', '5 minutes', '1 hour', 'infinity', etc
-   */
-  ttl?: string;
-  /**
-   * full GUID (including prefix)
-   */
-  $guid?: string;
-  /**
-   * exec, hook, proxy
-   */
-  $type?: string;
-  /**
-   * if set to false explicitly it will not await the result
-   */
-  await?: boolean;
-  /**
-   * taskQueue for the workflowId (defaults to entity)
-   */
-  taskQueue?: string;
-  /**
-   * defaults to `entity` input parameter; allows override of the workflowId prefix
-   */
-  prefix?: string;
-  search?: WorkflowSearchOptions;
-  /**
-   * list of  state field names to return (this is NOT the final response)
-   */
-  fields?: string[];
-  /**
-   * namespace for the the execution client
-   * @default 'memflow'
-   */
-  namespace?: string;
-
-  /**
-   * Custom marker data field used for adding a searchable marker to the job.
-   * markers always begin with a dash (-). Any field that does not
-   * begin with a dash will be removed and will not be inserted with
-   * the initial data set.
-   */
-  marker?: StringStringType;
-
-  /**
-   * If provided, the job will initialize in an pending state, reserving
-   * only the job ID (HSETNX) and persisting search and marker (if provided).
-   * If a `resume` signal is sent before the specified number of seconds,
-   * the job will resume as normal. If the job is not resumed within the
-   * number of seconds provided, the job will be scrubbed. No dependencies
-   * are set for a job in a pending state; however, dependencies will be
-   * added after the job is resumed if necessary.
-   */
-  pending?: number;
-
-  //flush?: boolean;
-};
-
-export type ConnectOptions = {
-  /**
-   * the task queue for the connected function for greater specificity
-   */
-  taskQueue?: string;
-  /**
-   * prefix for the workflowId (defaults to entity value if not provided)
-   */
-  prefix?: string;
-  /**
-   * optional namespace for the the worker
-   * @default 'memflow'
-   */
-  namespace?: string;
-  /**
-   * extended worker options
-   */
-  options?: WorkerOptions;
-  /**
-   * optional search configuration
-   */
-  search?: WorkflowSearchOptions;
-};
-
-/**
- * Connect a function to the operational data layer.
- * @template T - the return type of the connected function
- */
-export type ConnectionInput<T> = {
-  /**
-   * The connected function's entity identifier
-   *
-   * @example
-   * user
-   */
-  entity: string;
-  /**
-   * The target function reference
-   *
-   * @example
-   * function() { return "hello world" }
-   */
-  target: (...args: any[]) => T;
-  /**
-   * Extended connection options (e.g., ttl, taskQueue)
-   * @example
-   * { ttl: 'infinity' }
-   */
-  options?: ConnectOptions;
-};
-
-/**
- * Executes a remote function by its global entity identifier with specified arguments.
- * If options.ttl is infinity, the function will be cached indefinitely and can only be
- * removed by calling `flush`. During this time, the function will remain active and can
- * its state can be augmented by calling `set`, `incr`, `del`, etc OR by calling a
- * transactional 'hook' function.
- *
- * @template T The expected return type of the remote function.
- */
-export type ExecInput = {
-  /**
-   * the connected function's entity identifier
-   * @example
-   * user
-   */
-  entity: string;
-  /**
-   * the function's input arguments
-   * @example
-   * ['Jane', 'Doe']
-   */
-  args: any[];
-  /**
-   * Extended options for the hook function, like specifying a taskQueue or ttl
-   * @example
-   * { ttl: '5 minutes' }
-   */
-  options?: Partial<MeshDataWorkflowOptions>;
-};
-
-/**
- * Hook function inputs. Hooks augment running jobs.
- */
-export type HookInput = {
-  /**
-   * The target function's entity identifier
-   * @example 'user'
-   */
-  entity: string;
-  /**
-   * The target execution id (workflowId/jobId)
-   * @example 'jsmith123'
-   */
-  id: string;
-  /**
-   * The hook function's entity identifier
-   * @example 'user.notify'
-   */
-  hookEntity: string;
-  /**
-   * The hook function's input arguments
-   * @example 'notify'
-   */
-  hookArgs: any[];
-  /**
-   * Extended options for the hook function, like specifying a taskQueue
-   * @example { taskQueue: 'priority' }
-   */
-  options?: Partial<HookOptions>;
-};
-
-export type MeshDataWorkflowOptions = {
-  /**
-   * The app deployment namespace
-   */
-  namespace?: string;
-
-  /**
-   * Target connected functions more specifically by taskQueue
-   */
-  taskQueue?: string;
-
-  /**
-   * The connected function's entity identifier
-   */
-  prefix?: string;
-
-  /**
-   * The function execution id (shorthand for workflowId)
-   */
-  id?: string;
-
-  /**
-   * The function execution id
-   */
-  workflowId?: string;
-
-  /**
-   * The function name (`entity` is a shorthand for this)
-   */
-  workflowName?: string;
-
-  /**
-   * The open telemetry trace context for the workflow, used for logging and tracing. If a sink is enabled, this will be sent to the sink.
-   */
-  workflowTrace?: string;
-
-  /**
-   * The open telemetry span context for the workflow, used for logging and tracing. If a sink is enabled, this will be sent to the sink.
-   */
-  workflowSpan?: string;
-
-  /**
-   * Search fields to seed function state when it first initializes
-   */
-  search?: WorkflowSearchOptions;
-
-  /**
-   * Extended execution options
-   */
-  config?: WorkflowConfig;
-
-  /**
-   * Set to 'infinity', '1 minute', '1 hour', etc
-   */
-  ttl?: string;
-
-  /**
-   * If set to false explicitly it will not await the result
-   * @default true
-   */
-  await?: boolean;
-
-  /**
-   * Custom marker data field used for adding a searchable marker to the job.
-   * markers always begin with a dash (-). Any field that does not
-   * begin with a dash will be removed and will not be inserted with
-   * the initial data set.
-   */
-  marker?: StringStringType;
-
-  /**
-   * If provided, the job will initialize in a pending state, reserving
-   * only the job ID (HSETNX) and persisting search and marker (if provided).
-   * If a `resume` signal is sent before the specified number of seconds,
-   * the job will resume as normal. If the job is not resumed within the
-   * number of seconds provided, the job will be scrubbed. No dependencies
-   * are set for a job in a pending state; however, dependencies will be
-   * added after the job is resumed (if necessary).
-   */
-  pending?: number;
-
-  /**
-   * sets the number of seconds a workflow may exist after completion. As the process engine is an in-memory cache, the default policy is to expire and scrub the job hash as soon as it completes.
-   * @default 1
-   */
-  expire?: number;
-
-  /**
-   * set to false to optimize workflows that do not require a `signal in`.
-   * explicitly set to true to force the workflow to remain open and persistent.
-   * @default true
-   */
-  signalIn?: boolean;
-
-  /**
-   * set to `true` by the system when a workflow is started with a ttl, ensuring
-   * that the workflow will remain active until the ttl expires and the workflow
-   * is scrubbed. This is a system flag and should not be set by the user.
-   */
-  persistent?: boolean;
-};

package/types/ms.d.ts

@@ -1,7 +0,0 @@
-declare module 'ms' {
-  function ms(value: string): number;
-  function ms(value: number): string;
-  function ms(value: string | number): string | number;
-
-  export = ms;
-}