@character-foundry/character-foundry 0.4.2 → 0.4.3-dev.1766103111

package/dist/federation.d.cts

@@ -21,8 +21,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 		character_book: z.ZodNullable<z.ZodOptional<z.ZodObject<{
 			name: z.ZodOptional<z.ZodString>;
 			description: z.ZodOptional<z.ZodString>;
-			scan_depth: z.ZodOptional<z.ZodNumber>;
-			token_budget: z.ZodOptional<z.ZodNumber>;
+			scan_depth: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+			token_budget: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
 			recursive_scanning: z.ZodOptional<z.ZodBoolean>;
 			extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 			entries: z.ZodArray<z.ZodObject<{
@@ -41,7 +41,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -84,7 +85,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -127,7 +129,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -172,7 +175,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -223,7 +227,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -253,14 +258,14 @@ declare const CCv3DataSchema: z.ZodObject<{
 			}, z.ZodTypeAny, "passthrough">[];
 			name?: string | undefined;
 			description?: string | undefined;
-			scan_depth?: number | undefined;
-			token_budget?: number | undefined;
+			scan_depth?: unknown;
+			token_budget?: unknown;
 			recursive_scanning?: boolean | undefined;
 			extensions?: Record<string, unknown> | undefined;
 		}>>>;
 		extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 		assets: z.ZodOptional<z.ZodArray<z.ZodObject<{
-			type: z.ZodEnum<[
+			type: z.ZodEffects<z.ZodEnum<[
 				"icon",
 				"background",
 				"emotion",
@@ -269,7 +274,7 @@ declare const CCv3DataSchema: z.ZodObject<{
 				"video",
 				"custom",
 				"x-risu-asset"
-			]>;
+			]>, "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset", unknown>;
 			uri: z.ZodString;
 			name: z.ZodString;
 			ext: z.ZodString;
@@ -280,15 +285,15 @@ declare const CCv3DataSchema: z.ZodObject<{
 			ext: string;
 		}, {
 			name: string;
-			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 			uri: string;
 			ext: string;
+			type?: unknown;
 		}>, "many">>;
 		nickname: z.ZodOptional<z.ZodString>;
 		creator_notes_multilingual: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 		source: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-		creation_date: z.ZodOptional<z.ZodNumber>;
-		modification_date: z.ZodOptional<z.ZodNumber>;
+		creation_date: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+		modification_date: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
 	}, "strip", z.ZodTypeAny, {
 		name: string;
 		description: string;
@@ -322,7 +327,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -397,7 +403,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -427,8 +434,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 			}, z.ZodTypeAny, "passthrough">[];
 			name?: string | undefined;
 			description?: string | undefined;
-			scan_depth?: number | undefined;
-			token_budget?: number | undefined;
+			scan_depth?: unknown;
+			token_budget?: unknown;
 			recursive_scanning?: boolean | undefined;
 			extensions?: Record<string, unknown> | undefined;
 		} | null | undefined;
@@ -438,15 +445,15 @@ declare const CCv3DataSchema: z.ZodObject<{
 		group_only_greetings?: string[] | undefined;
 		assets?: {
 			name: string;
-			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 			uri: string;
 			ext: string;
+			type?: unknown;
 		}[] | undefined;
 		nickname?: string | undefined;
 		creator_notes_multilingual?: Record<string, string> | undefined;
 		source?: string[] | undefined;
-		creation_date?: number | undefined;
-		modification_date?: number | undefined;
+		creation_date?: unknown;
+		modification_date?: unknown;
 	}>;
 }, "strip", z.ZodTypeAny, {
 	data: {
@@ -482,7 +489,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -561,7 +569,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -591,8 +600,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 			}, z.ZodTypeAny, "passthrough">[];
 			name?: string | undefined;
 			description?: string | undefined;
-			scan_depth?: number | undefined;
-			token_budget?: number | undefined;
+			scan_depth?: unknown;
+			token_budget?: unknown;
 			recursive_scanning?: boolean | undefined;
 			extensions?: Record<string, unknown> | undefined;
 		} | null | undefined;
@@ -602,15 +611,15 @@ declare const CCv3DataSchema: z.ZodObject<{
 		group_only_greetings?: string[] | undefined;
 		assets?: {
 			name: string;
-			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 			uri: string;
 			ext: string;
+			type?: unknown;
 		}[] | undefined;
 		nickname?: string | undefined;
 		creator_notes_multilingual?: Record<string, string> | undefined;
 		source?: string[] | undefined;
-		creation_date?: number | undefined;
-		modification_date?: number | undefined;
+		creation_date?: unknown;
+		modification_date?: unknown;
 	};
 	spec: "chara_card_v3";
 	spec_version: "3.0";
@@ -619,6 +628,23 @@ declare const CCv3DataSchema: z.ZodObject<{
  * Character Card v3 full structure
  */
 export type CCv3Data = z.infer<typeof CCv3DataSchema>;
+/**
+ * Federation Logger
+ *
+ * Lightweight logger with configurable verbosity and a safe default (warn).
+ * No external dependencies.
+ */
+export type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
+export interface Logger {
+	debug: (...args: unknown[]) => void;
+	info: (...args: unknown[]) => void;
+	warn: (...args: unknown[]) => void;
+	error: (...args: unknown[]) => void;
+}
+export declare function createConsoleLogger(level?: LogLevel): Logger;
+declare function getLogger(): Logger;
+declare function setLogger(logger: Logger): void;
+declare function setLogLevel(level: LogLevel): void;
 /**
  * Federation Types
  *
@@ -978,6 +1004,17 @@ export interface InboxHandlerOptions {
 	strictMode?: boolean;
 	/** Maximum age for signatures in seconds (default 300) */
 	maxAge?: number;
+	/**
+	 * Optional shared network key for internal-only federation.
+	 *
+	 * When set, incoming requests must include a matching network key header.
+	 * In strictMode, the header must also be included in the signed header list.
+	 */
+	networkKey?: string;
+	/**
+	 * Header name for the shared network key (default: X-Foundry-Network-Key)
+	 */
+	networkKeyHeader?: string;
 }
 /**
  * ActivityPub Utilities
@@ -3098,6 +3135,10 @@ export declare class RateLimiter {
  */
 export declare function enableFederation(options?: {
 	skipEnvCheck?: boolean;
+	/** Optional logger override */
+	logger?: Logger;
+	/** Optional log level (used when logger is not provided). Default: warn */
+	logLevel?: LogLevel;
 }): void;
 /**
  * Check if federation is enabled
@@ -3113,6 +3154,9 @@ export declare function isFederationEnabled(): boolean;
 export declare function assertFederationEnabled(feature: string): void;
 
 export {
+	getLogger as getFederationLogger,
+	setLogLevel as setFederationLogLevel,
+	setLogger as setFederationLogger,
 	validateActivitySignature as validateHttpSignature,
 	validateBlockActivity as validateBlockActivityFields,
 	validateFlagActivity as validateFlagActivityFields,

package/dist/federation.d.ts

@@ -21,8 +21,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 		character_book: z.ZodNullable<z.ZodOptional<z.ZodObject<{
 			name: z.ZodOptional<z.ZodString>;
 			description: z.ZodOptional<z.ZodString>;
-			scan_depth: z.ZodOptional<z.ZodNumber>;
-			token_budget: z.ZodOptional<z.ZodNumber>;
+			scan_depth: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+			token_budget: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
 			recursive_scanning: z.ZodOptional<z.ZodBoolean>;
 			extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 			entries: z.ZodArray<z.ZodObject<{
@@ -41,7 +41,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -84,7 +85,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -127,7 +129,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -172,7 +175,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -223,7 +227,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -253,14 +258,14 @@ declare const CCv3DataSchema: z.ZodObject<{
 			}, z.ZodTypeAny, "passthrough">[];
 			name?: string | undefined;
 			description?: string | undefined;
-			scan_depth?: number | undefined;
-			token_budget?: number | undefined;
+			scan_depth?: unknown;
+			token_budget?: unknown;
 			recursive_scanning?: boolean | undefined;
 			extensions?: Record<string, unknown> | undefined;
 		}>>>;
 		extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 		assets: z.ZodOptional<z.ZodArray<z.ZodObject<{
-			type: z.ZodEnum<[
+			type: z.ZodEffects<z.ZodEnum<[
 				"icon",
 				"background",
 				"emotion",
@@ -269,7 +274,7 @@ declare const CCv3DataSchema: z.ZodObject<{
 				"video",
 				"custom",
 				"x-risu-asset"
-			]>;
+			]>, "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset", unknown>;
 			uri: z.ZodString;
 			name: z.ZodString;
 			ext: z.ZodString;
@@ -280,15 +285,15 @@ declare const CCv3DataSchema: z.ZodObject<{
 			ext: string;
 		}, {
 			name: string;
-			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 			uri: string;
 			ext: string;
+			type?: unknown;
 		}>, "many">>;
 		nickname: z.ZodOptional<z.ZodString>;
 		creator_notes_multilingual: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 		source: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-		creation_date: z.ZodOptional<z.ZodNumber>;
-		modification_date: z.ZodOptional<z.ZodNumber>;
+		creation_date: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+		modification_date: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
 	}, "strip", z.ZodTypeAny, {
 		name: string;
 		description: string;
@@ -322,7 +327,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -397,7 +403,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -427,8 +434,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 			}, z.ZodTypeAny, "passthrough">[];
 			name?: string | undefined;
 			description?: string | undefined;
-			scan_depth?: number | undefined;
-			token_budget?: number | undefined;
+			scan_depth?: unknown;
+			token_budget?: unknown;
 			recursive_scanning?: boolean | undefined;
 			extensions?: Record<string, unknown> | undefined;
 		} | null | undefined;
@@ -438,15 +445,15 @@ declare const CCv3DataSchema: z.ZodObject<{
 		group_only_greetings?: string[] | undefined;
 		assets?: {
 			name: string;
-			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 			uri: string;
 			ext: string;
+			type?: unknown;
 		}[] | undefined;
 		nickname?: string | undefined;
 		creator_notes_multilingual?: Record<string, string> | undefined;
 		source?: string[] | undefined;
-		creation_date?: number | undefined;
-		modification_date?: number | undefined;
+		creation_date?: unknown;
+		modification_date?: unknown;
 	}>;
 }, "strip", z.ZodTypeAny, {
 	data: {
@@ -482,7 +489,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -561,7 +569,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 				position: z.ZodOptional<z.ZodNullable<z.ZodUnion<[
 					z.ZodEnum<[
 						"before_char",
-						"after_char"
+						"after_char",
+						"in_chat"
 					]>,
 					z.ZodNumber,
 					z.ZodLiteral<"">
@@ -591,8 +600,8 @@ declare const CCv3DataSchema: z.ZodObject<{
 			}, z.ZodTypeAny, "passthrough">[];
 			name?: string | undefined;
 			description?: string | undefined;
-			scan_depth?: number | undefined;
-			token_budget?: number | undefined;
+			scan_depth?: unknown;
+			token_budget?: unknown;
 			recursive_scanning?: boolean | undefined;
 			extensions?: Record<string, unknown> | undefined;
 		} | null | undefined;
@@ -602,15 +611,15 @@ declare const CCv3DataSchema: z.ZodObject<{
 		group_only_greetings?: string[] | undefined;
 		assets?: {
 			name: string;
-			type: "custom" | "icon" | "background" | "emotion" | "user_icon" | "sound" | "video" | "x-risu-asset";
 			uri: string;
 			ext: string;
+			type?: unknown;
 		}[] | undefined;
 		nickname?: string | undefined;
 		creator_notes_multilingual?: Record<string, string> | undefined;
 		source?: string[] | undefined;
-		creation_date?: number | undefined;
-		modification_date?: number | undefined;
+		creation_date?: unknown;
+		modification_date?: unknown;
 	};
 	spec: "chara_card_v3";
 	spec_version: "3.0";
@@ -619,6 +628,23 @@ declare const CCv3DataSchema: z.ZodObject<{
  * Character Card v3 full structure
  */
 export type CCv3Data = z.infer<typeof CCv3DataSchema>;
+/**
+ * Federation Logger
+ *
+ * Lightweight logger with configurable verbosity and a safe default (warn).
+ * No external dependencies.
+ */
+export type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
+export interface Logger {
+	debug: (...args: unknown[]) => void;
+	info: (...args: unknown[]) => void;
+	warn: (...args: unknown[]) => void;
+	error: (...args: unknown[]) => void;
+}
+export declare function createConsoleLogger(level?: LogLevel): Logger;
+declare function getLogger(): Logger;
+declare function setLogger(logger: Logger): void;
+declare function setLogLevel(level: LogLevel): void;
 /**
  * Federation Types
  *
@@ -978,6 +1004,17 @@ export interface InboxHandlerOptions {
 	strictMode?: boolean;
 	/** Maximum age for signatures in seconds (default 300) */
 	maxAge?: number;
+	/**
+	 * Optional shared network key for internal-only federation.
+	 *
+	 * When set, incoming requests must include a matching network key header.
+	 * In strictMode, the header must also be included in the signed header list.
+	 */
+	networkKey?: string;
+	/**
+	 * Header name for the shared network key (default: X-Foundry-Network-Key)
+	 */
+	networkKeyHeader?: string;
 }
 /**
  * ActivityPub Utilities
@@ -3098,6 +3135,10 @@ export declare class RateLimiter {
  */
 export declare function enableFederation(options?: {
 	skipEnvCheck?: boolean;
+	/** Optional logger override */
+	logger?: Logger;
+	/** Optional log level (used when logger is not provided). Default: warn */
+	logLevel?: LogLevel;
 }): void;
 /**
  * Check if federation is enabled
@@ -3113,6 +3154,9 @@ export declare function isFederationEnabled(): boolean;
 export declare function assertFederationEnabled(feature: string): void;
 
 export {
+	getLogger as getFederationLogger,
+	setLogLevel as setFederationLogLevel,
+	setLogger as setFederationLogger,
 	validateActivitySignature as validateHttpSignature,
 	validateBlockActivity as validateBlockActivityFields,
 	validateFlagActivity as validateFlagActivityFields,