@jaypie/fabric 0.1.1 → 0.1.2

package/dist/cjs/convert-date.d.ts

@@ -1,47 +0,0 @@
-/**
- * Date Type Conversion for @jaypie/fabric
- *
- * Adds Date as a supported type in the fabric type system.
- * Follows the same conversion patterns as String, Number, Boolean.
- */
-/**
- * Check if a value is a valid Date
- */
-export declare function isValidDate(value: unknown): value is Date;
-/**
- * Convert a value to a Date
- *
- * Supported inputs:
- * - Date: returned as-is (validated)
- * - Number: treated as Unix timestamp (milliseconds)
- * - String: parsed via Date constructor (ISO 8601, etc.)
- * - Object with value property: unwrapped and converted
- *
- * @throws BadRequestError if value cannot be converted to valid Date
- */
-export declare function fabricDate(value: unknown): Date;
-/**
- * Convert a value from a Date to another type
- *
- * @param value - Date to convert
- * @param targetType - Target type (String, Number)
- */
-export declare function convertFromDate(value: Date, targetType: typeof Number | typeof String): number | string;
-/**
- * Date type constant for use in fabricService input definitions
- *
- * Usage:
- * ```typescript
- * const handler = fabricService({
- *   input: {
- *     startDate: { type: Date },
- *     endDate: { type: Date, default: undefined }
- *   }
- * });
- * ```
- */
-export declare const DateType: DateConstructor;
-/**
- * Type guard for Date type in schema definitions
- */
-export declare function isDateType(type: unknown): type is typeof Date;

package/dist/cjs/convert.d.ts

@@ -1,69 +0,0 @@
-import type { ConversionType } from "./types.js";
-/**
- * Convert a value to a boolean
- * - Arrays, objects, and JSON strings are unwrapped first
- * - String "true" becomes true
- * - String "false" becomes false
- * - Strings that parse to numbers: positive = true, zero or negative = false
- * - Numbers: positive = true, zero or negative = false
- * - Boolean passes through
- */
-export declare function fabricBoolean(value: unknown): boolean | undefined;
-/**
- * Convert a value to a number
- * - Arrays, objects, and JSON strings are unwrapped first
- * - String "" becomes undefined
- * - String "true" becomes 1
- * - String "false" becomes 0
- * - Strings that parse to numbers use those values
- * - Strings that parse to NaN throw BadRequestError
- * - Boolean true becomes 1, false becomes 0
- * - Number passes through
- */
-export declare function fabricNumber(value: unknown): number | undefined;
-/**
- * Convert a value to a string
- * - Arrays, objects, and JSON strings are unwrapped first
- * - String "" becomes undefined
- * - Boolean true becomes "true", false becomes "false"
- * - Number converts to string representation
- * - String passes through
- */
-export declare function fabricString(value: unknown): string | undefined;
-/**
- * Convert a value to an array
- * - Non-arrays become arrays containing that value
- * - Arrays of a single value become that value (unwrapped)
- * - Multi-value arrays throw BadRequestError
- * - undefined/null become undefined
- */
-export declare function fabricArray(value: unknown): unknown[] | undefined;
-/**
- * Convert a value from an array to a scalar
- * - Single-element arrays become that element
- * - Multi-element arrays throw BadRequestError
- * - Non-arrays pass through
- */
-export declare function convertFromArray(value: unknown): unknown;
-/**
- * Convert a value to an object with a value property
- * - Scalars become { value: scalar }
- * - Arrays become { value: array }
- * - Objects with a value attribute pass through
- * - Objects without a value attribute throw BadRequestError
- * - undefined/null become undefined
- */
-export declare function fabricObject(value: unknown): {
-    value: unknown;
-} | undefined;
-/**
- * Convert a value from an object to its value property
- * - Objects with a value property return that value
- * - Objects without a value throw BadRequestError
- * - Scalars pass through
- */
-export declare function convertFromObject(value: unknown): unknown;
-/**
- * Fabric a value to the specified type
- */
-export declare function fabric(value: unknown, type: ConversionType): unknown;

package/dist/cjs/lambda/createLambdaService.d.ts

@@ -1,33 +0,0 @@
-import type { Service } from "../types.js";
-import type { CreateLambdaServiceConfig, CreateLambdaServiceOptions, CreateLambdaServiceResult } from "./types.js";
-/**
- * Create a Lambda handler that wraps a service
- *
- * This function creates a Lambda-compatible handler that:
- * - Uses getMessages() to extract messages from SQS/SNS events
- * - Calls the service once for each message
- * - Returns the single response if one message, or an array of responses if multiple
- * - Integrates with lambdaHandler for lifecycle management (secrets, setup, teardown, etc.)
- *
- * @param handlerOrConfig - The service function or configuration object
- * @param options - Lambda handler options (secrets, setup, teardown, etc.)
- * @returns A Lambda handler function
- *
- * @example
- * ```typescript
- * import { createLambdaService } from "@jaypie/fabric/lambda";
- * import { myService } from "./services";
- *
- * // Config object style
- * export const handler = createLambdaService({
- *   handler: myService,
- *   secrets: ["ANTHROPIC_API_KEY", "OPENAI_API_KEY"],
- * });
- *
- * // Handler with options style
- * export const handler2 = createLambdaService(myService, {
- *   secrets: ["ANTHROPIC_API_KEY"],
- * });
- * ```
- */
-export declare function createLambdaService<TResult = unknown>(handlerOrConfig: CreateLambdaServiceConfig | Service, options?: CreateLambdaServiceOptions): CreateLambdaServiceResult<TResult | TResult[]>;

package/dist/cjs/llm/createLlmTool.d.ts

@@ -1,40 +0,0 @@
-import type { CreateLlmToolConfig, CreateLlmToolResult } from "./types.js";
-/**
- * Create an LLM tool from a fabric service
- *
- * This function creates an LLM tool compatible with @jaypie/llm Toolkit.
- * It automatically:
- * - Uses handler.alias as the tool name (or custom name)
- * - Uses handler.description as the tool description (or custom)
- * - Converts input definitions to JSON Schema parameters
- * - Wraps the service as the tool's call function
- *
- * @param config - Configuration including handler and optional overrides
- * @returns An object containing the created LLM tool
- *
- * @example
- * ```typescript
- * import { createService } from "@jaypie/fabric";
- * import { createLlmTool } from "@jaypie/fabric/llm";
- * import { Toolkit } from "@jaypie/llm";
- *
- * const handler = createService({
- *   alias: "greet",
- *   description: "Greet a user by name",
- *   input: {
- *     userName: { type: String, description: "The user's name" },
- *     loud: { type: Boolean, default: false, description: "Shout the greeting" },
- *   },
- *   service: ({ userName, loud }) => {
- *     const greeting = `Hello, ${userName}!`;
- *     return loud ? greeting.toUpperCase() : greeting;
- *   },
- * });
- *
- * const { tool } = createLlmTool({ handler });
- *
- * // Use with Toolkit
- * const toolkit = new Toolkit([tool]);
- * ```
- */
-export declare function createLlmTool(config: CreateLlmToolConfig): CreateLlmToolResult;

package/dist/cjs/mcp/registerMcpTool.d.ts

@@ -1,38 +0,0 @@
-import type { RegisterMcpToolConfig, RegisterMcpToolResult } from "./types.js";
-/**
- * Register a fabric service as an MCP tool
- *
- * This function registers a service with an MCP server.
- * It automatically:
- * - Uses handler.alias as the tool name (or custom name)
- * - Uses handler.description as the tool description (or custom)
- * - Delegates validation to the service
- * - Wraps the service and formats the response
- *
- * @param config - Configuration including handler, server, and optional overrides
- * @returns An object containing the registered tool name
- *
- * @example
- * ```typescript
- * import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
- * import { createService } from "@jaypie/fabric";
- * import { registerMcpTool } from "@jaypie/fabric/mcp";
- *
- * const handler = createService({
- *   alias: "greet",
- *   description: "Greet a user by name",
- *   input: {
- *     userName: { type: String, description: "The user's name" },
- *     loud: { type: Boolean, default: false, description: "Shout the greeting" },
- *   },
- *   service: ({ userName, loud }) => {
- *     const greeting = `Hello, ${userName}!`;
- *     return loud ? greeting.toUpperCase() : greeting;
- *   },
- * });
- *
- * const server = new McpServer({ name: "my-server", version: "1.0.0" });
- * registerMcpTool({ handler, server });
- * ```
- */
-export declare function registerMcpTool(config: RegisterMcpToolConfig): RegisterMcpToolResult;

package/dist/cjs/types/fieldCategory.d.ts

@@ -1,20 +0,0 @@
-/**
- * Field Categories - Semantic classification of fields
- *
- * Categories define the semantic boundary of fields within models.
- */
-/** Field categories defining semantic boundaries */
-export declare const FIELD_CATEGORIES: readonly ["identity", "input", "metadata", "state"];
-/**
- * Field category - semantic classification of fields
- *
- * - identity: What the model IS (immutable) - id, model, ou
- * - metadata: What the model is ABOUT (usually immutable) - alias, xid, class, type
- * - state: What the model TRACKS (mutable) - content, status, progress
- * - input: Request parameters (transient) - data, params, options
- */
-export type FieldCategory = (typeof FIELD_CATEGORIES)[number];
-/**
- * Check if a string is a valid field category
- */
-export declare function isFieldCategory(value: unknown): value is FieldCategory;

package/dist/esm/commander/registerServiceCommand.d.ts

@@ -1,43 +0,0 @@
-import type { RegisterServiceCommandConfig, RegisterServiceCommandResult } from "./types.js";
-/**
- * Register a service as a Commander.js command
- *
- * This function creates a command from a service, automatically:
- * - Creating the command with the handler's alias (or custom name)
- * - Adding a description from the handler's description (or custom)
- * - Converting input definitions to Commander options
- * - Wiring up the action to call the handler with parsed input
- *
- * Error handling:
- * - Services can call context.onError() for recoverable errors
- * - Services can call context.onFatal() for fatal errors
- * - Any error that throws out of the service is treated as fatal
- *
- * @param config - Configuration including handler, program, and optional overrides
- * @returns An object containing the created command
- *
- * @example
- * ```typescript
- * import { Command } from "commander";
- * import { createService } from "@jaypie/fabric";
- * import { registerServiceCommand } from "@jaypie/fabric/commander";
- *
- * const handler = createService({
- *   alias: "greet",
- *   description: "Greet a user",
- *   input: {
- *     userName: { type: String, description: "User name" },
- *     loud: { type: Boolean, description: "Shout greeting" },
- *   },
- *   service: ({ userName, loud }) => {
- *     const greeting = `Hello, ${userName}!`;
- *     return loud ? greeting.toUpperCase() : greeting;
- *   },
- * });
- *
- * const program = new Command();
- * registerServiceCommand({ handler, program });
- * program.parse();
- * ```
- */
-export declare function registerServiceCommand({ description, exclude, handler, name, onComplete, onError, onFatal, onMessage, overrides, program, }: RegisterServiceCommandConfig): RegisterServiceCommandResult;

package/dist/esm/convert-date.d.ts

@@ -1,47 +0,0 @@
-/**
- * Date Type Conversion for @jaypie/fabric
- *
- * Adds Date as a supported type in the fabric type system.
- * Follows the same conversion patterns as String, Number, Boolean.
- */
-/**
- * Check if a value is a valid Date
- */
-export declare function isValidDate(value: unknown): value is Date;
-/**
- * Convert a value to a Date
- *
- * Supported inputs:
- * - Date: returned as-is (validated)
- * - Number: treated as Unix timestamp (milliseconds)
- * - String: parsed via Date constructor (ISO 8601, etc.)
- * - Object with value property: unwrapped and converted
- *
- * @throws BadRequestError if value cannot be converted to valid Date
- */
-export declare function fabricDate(value: unknown): Date;
-/**
- * Convert a value from a Date to another type
- *
- * @param value - Date to convert
- * @param targetType - Target type (String, Number)
- */
-export declare function convertFromDate(value: Date, targetType: typeof Number | typeof String): number | string;
-/**
- * Date type constant for use in fabricService input definitions
- *
- * Usage:
- * ```typescript
- * const handler = fabricService({
- *   input: {
- *     startDate: { type: Date },
- *     endDate: { type: Date, default: undefined }
- *   }
- * });
- * ```
- */
-export declare const DateType: DateConstructor;
-/**
- * Type guard for Date type in schema definitions
- */
-export declare function isDateType(type: unknown): type is typeof Date;

package/dist/esm/convert.d.ts

@@ -1,69 +0,0 @@
-import type { ConversionType } from "./types.js";
-/**
- * Convert a value to a boolean
- * - Arrays, objects, and JSON strings are unwrapped first
- * - String "true" becomes true
- * - String "false" becomes false
- * - Strings that parse to numbers: positive = true, zero or negative = false
- * - Numbers: positive = true, zero or negative = false
- * - Boolean passes through
- */
-export declare function fabricBoolean(value: unknown): boolean | undefined;
-/**
- * Convert a value to a number
- * - Arrays, objects, and JSON strings are unwrapped first
- * - String "" becomes undefined
- * - String "true" becomes 1
- * - String "false" becomes 0
- * - Strings that parse to numbers use those values
- * - Strings that parse to NaN throw BadRequestError
- * - Boolean true becomes 1, false becomes 0
- * - Number passes through
- */
-export declare function fabricNumber(value: unknown): number | undefined;
-/**
- * Convert a value to a string
- * - Arrays, objects, and JSON strings are unwrapped first
- * - String "" becomes undefined
- * - Boolean true becomes "true", false becomes "false"
- * - Number converts to string representation
- * - String passes through
- */
-export declare function fabricString(value: unknown): string | undefined;
-/**
- * Convert a value to an array
- * - Non-arrays become arrays containing that value
- * - Arrays of a single value become that value (unwrapped)
- * - Multi-value arrays throw BadRequestError
- * - undefined/null become undefined
- */
-export declare function fabricArray(value: unknown): unknown[] | undefined;
-/**
- * Convert a value from an array to a scalar
- * - Single-element arrays become that element
- * - Multi-element arrays throw BadRequestError
- * - Non-arrays pass through
- */
-export declare function convertFromArray(value: unknown): unknown;
-/**
- * Convert a value to an object with a value property
- * - Scalars become { value: scalar }
- * - Arrays become { value: array }
- * - Objects with a value attribute pass through
- * - Objects without a value attribute throw BadRequestError
- * - undefined/null become undefined
- */
-export declare function fabricObject(value: unknown): {
-    value: unknown;
-} | undefined;
-/**
- * Convert a value from an object to its value property
- * - Objects with a value property return that value
- * - Objects without a value throw BadRequestError
- * - Scalars pass through
- */
-export declare function convertFromObject(value: unknown): unknown;
-/**
- * Fabric a value to the specified type
- */
-export declare function fabric(value: unknown, type: ConversionType): unknown;

package/dist/esm/lambda/createLambdaService.d.ts

@@ -1,33 +0,0 @@
-import type { Service } from "../types.js";
-import type { CreateLambdaServiceConfig, CreateLambdaServiceOptions, CreateLambdaServiceResult } from "./types.js";
-/**
- * Create a Lambda handler that wraps a service
- *
- * This function creates a Lambda-compatible handler that:
- * - Uses getMessages() to extract messages from SQS/SNS events
- * - Calls the service once for each message
- * - Returns the single response if one message, or an array of responses if multiple
- * - Integrates with lambdaHandler for lifecycle management (secrets, setup, teardown, etc.)
- *
- * @param handlerOrConfig - The service function or configuration object
- * @param options - Lambda handler options (secrets, setup, teardown, etc.)
- * @returns A Lambda handler function
- *
- * @example
- * ```typescript
- * import { createLambdaService } from "@jaypie/fabric/lambda";
- * import { myService } from "./services";
- *
- * // Config object style
- * export const handler = createLambdaService({
- *   handler: myService,
- *   secrets: ["ANTHROPIC_API_KEY", "OPENAI_API_KEY"],
- * });
- *
- * // Handler with options style
- * export const handler2 = createLambdaService(myService, {
- *   secrets: ["ANTHROPIC_API_KEY"],
- * });
- * ```
- */
-export declare function createLambdaService<TResult = unknown>(handlerOrConfig: CreateLambdaServiceConfig | Service, options?: CreateLambdaServiceOptions): CreateLambdaServiceResult<TResult | TResult[]>;

package/dist/esm/llm/createLlmTool.d.ts

@@ -1,40 +0,0 @@
-import type { CreateLlmToolConfig, CreateLlmToolResult } from "./types.js";
-/**
- * Create an LLM tool from a fabric service
- *
- * This function creates an LLM tool compatible with @jaypie/llm Toolkit.
- * It automatically:
- * - Uses handler.alias as the tool name (or custom name)
- * - Uses handler.description as the tool description (or custom)
- * - Converts input definitions to JSON Schema parameters
- * - Wraps the service as the tool's call function
- *
- * @param config - Configuration including handler and optional overrides
- * @returns An object containing the created LLM tool
- *
- * @example
- * ```typescript
- * import { createService } from "@jaypie/fabric";
- * import { createLlmTool } from "@jaypie/fabric/llm";
- * import { Toolkit } from "@jaypie/llm";
- *
- * const handler = createService({
- *   alias: "greet",
- *   description: "Greet a user by name",
- *   input: {
- *     userName: { type: String, description: "The user's name" },
- *     loud: { type: Boolean, default: false, description: "Shout the greeting" },
- *   },
- *   service: ({ userName, loud }) => {
- *     const greeting = `Hello, ${userName}!`;
- *     return loud ? greeting.toUpperCase() : greeting;
- *   },
- * });
- *
- * const { tool } = createLlmTool({ handler });
- *
- * // Use with Toolkit
- * const toolkit = new Toolkit([tool]);
- * ```
- */
-export declare function createLlmTool(config: CreateLlmToolConfig): CreateLlmToolResult;

package/dist/esm/mcp/registerMcpTool.d.ts

@@ -1,38 +0,0 @@
-import type { RegisterMcpToolConfig, RegisterMcpToolResult } from "./types.js";
-/**
- * Register a fabric service as an MCP tool
- *
- * This function registers a service with an MCP server.
- * It automatically:
- * - Uses handler.alias as the tool name (or custom name)
- * - Uses handler.description as the tool description (or custom)
- * - Delegates validation to the service
- * - Wraps the service and formats the response
- *
- * @param config - Configuration including handler, server, and optional overrides
- * @returns An object containing the registered tool name
- *
- * @example
- * ```typescript
- * import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
- * import { createService } from "@jaypie/fabric";
- * import { registerMcpTool } from "@jaypie/fabric/mcp";
- *
- * const handler = createService({
- *   alias: "greet",
- *   description: "Greet a user by name",
- *   input: {
- *     userName: { type: String, description: "The user's name" },
- *     loud: { type: Boolean, default: false, description: "Shout the greeting" },
- *   },
- *   service: ({ userName, loud }) => {
- *     const greeting = `Hello, ${userName}!`;
- *     return loud ? greeting.toUpperCase() : greeting;
- *   },
- * });
- *
- * const server = new McpServer({ name: "my-server", version: "1.0.0" });
- * registerMcpTool({ handler, server });
- * ```
- */
-export declare function registerMcpTool(config: RegisterMcpToolConfig): RegisterMcpToolResult;

package/dist/esm/types/fieldCategory.d.ts

@@ -1,20 +0,0 @@
-/**
- * Field Categories - Semantic classification of fields
- *
- * Categories define the semantic boundary of fields within models.
- */
-/** Field categories defining semantic boundaries */
-export declare const FIELD_CATEGORIES: readonly ["identity", "input", "metadata", "state"];
-/**
- * Field category - semantic classification of fields
- *
- * - identity: What the model IS (immutable) - id, model, ou
- * - metadata: What the model is ABOUT (usually immutable) - alias, xid, class, type
- * - state: What the model TRACKS (mutable) - content, status, progress
- * - input: Request parameters (transient) - data, params, options
- */
-export type FieldCategory = (typeof FIELD_CATEGORIES)[number];
-/**
- * Check if a string is a valid field category
- */
-export declare function isFieldCategory(value: unknown): value is FieldCategory;