Skip to content

@codesoul-co/hypha-storage / index

模块用法

聚合 @codesoul-co/hypha-storage 的公共入口导出;应用应从包入口导入这些 Symbol,不应依赖内部文件路径。

从包入口导入

ts
import {
  storageCapabilitySchema,
  storageConnectionSpecSchema,
  storageDeploymentModeSchema,
  storageEngineSchema,
  storageProviderKindSchema,
  storageProviderProfileDefinition,
  storageProviderProfileExample,
  storageProviderProfileJsonSchema,
} from '@codesoul-co/hypha-storage';

import type {
  ResolvedStorageConnection,
  StorageConnectionSpec,
  StorageProviderProfile,
  StorageSecretRef,
  StorageTopologySpec,
  EnvSource,
  StorageCapability,
  StorageDeploymentMode,
} from '@codesoul-co/hypha-storage';

// 完整导出列表见下方。

使用要点

  • 12 个类型/接口用于应用代码、Adapter 或测试中的静态契约;请使用 import type,运行时不应依赖它们。
  • 17 个函数是该模块的直接操作入口;每个 overload 的必需/可选参数与返回类型均在下方列出。
  • 17 个常量/枚举提供稳定值、Schema、Definition 或默认配置;应复用这些导出,避免在应用中复制内部值。

运行时校验示例

ts
import { storageCapabilitySchema } from '@codesoul-co/hypha-storage';

declare function loadExternalInput(): unknown;
const input: unknown = loadExternalInput();
const parsed = storageCapabilitySchema.parse(input);

配置、网络请求或持久化数据等不可信输入应先通过 Runtime Schema,再传给只接受已校验契约的函数或类。

公共导出

Symbol种类签名说明
storageCapabilitySchema常量const storageCapabilitySchema: z.ZodEnum<["structured", "transactions", "events", "cache", "queue", "pubsub", "streams", "vector_search", "metadata_filter", "artifact_bytes", "managed_backup", "tls", "multi_region"]>Storage Capability 的运行时 Schema。
storageConnectionSpecSchema常量const storageConnectionSpecSchema: z.ZodObject<{ uri: z.ZodOptional<z.ZodString>; uriEnv: z.ZodOptional<z.ZodString>; host: z.ZodOptional<z.ZodString>; port: z.ZodOptional<z.ZodNumber>; database: z.ZodOptional<z.ZodString>; username: z.ZodOptional<z.ZodString>; usernameEnv: z.ZodOptional<z.ZodString>; passwordEnv: z.ZodOptional<z.ZodString>; tls: z.ZodOptional<z.ZodBoolean>; region: z.ZodOptional<z.ZodString>; opt...Storage Connection Spec 的运行时 Schema。
storageDeploymentModeSchema常量const storageDeploymentModeSchema: z.ZodEnum<["local", "self_hosted", "managed", "cloud"]>Storage Deployment Mode 的运行时 Schema。
storageEngineSchema常量const storageEngineSchema: z.ZodEnum<["sqlite", "postgres", "mysql", "mongodb", "redis", "kafka", "local-vector", "pgvector", "qdrant", "milvus", "chroma", "pinecone", "weaviate", "file-artifact", "s3", "gcs", "azure-blob", "json"]>Storage Engine 的运行时 Schema。
storageProviderKindSchema常量const storageProviderKindSchema: z.ZodEnum<["relational", "document", "messaging", "cache", "vector", "object", "event", "hybrid"]>Storage Provider Kind 的运行时 Schema。
storageProviderProfileDefinition常量const storageProviderProfileDefinition: SpecSchemaDefinition<StorageProviderProfile>index 模块导出的 Storage Provider Profile Definition 常量。
storageProviderProfileExample常量const storageProviderProfileExample: StorageProviderProfileStorage Provider Profile 的有效示例值。
storageProviderProfileJsonSchema常量const storageProviderProfileJsonSchema: JsonSchemaStorage Provider Profile 的 JSON Schema。
storageProviderProfileSchema常量const storageProviderProfileSchema: z.ZodObject<{ id: z.ZodString; version: z.ZodString; } & { name: z.ZodOptional<z.ZodString>; description: z.ZodOptional<z.ZodString>; owner: z.ZodOptional<z.ZodString>; tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>; createdAt: z.ZodOptional<z.ZodString>; updatedAt: z.ZodOptional<z.ZodString>; } & { kind: z.ZodEnum<["relational", "document", "messaging", "cache", "vector",...Storage Provider Profile 的运行时 Schema。
storageRoleSchema常量const storageRoleSchema: z.ZodEnum<["source_of_truth", "event_log", "semantic_index", "cache", "message_queue", "artifact_store", "document_store", "hybrid_memory"]>Storage Role 的运行时 Schema。
storageSecretRefSchema常量const storageSecretRefSchema: z.ZodObject<{ env: z.ZodOptional<z.ZodString>; secretRef: z.ZodOptional<z.ZodString>; }, "strip", z.ZodTypeAny, { env?: string | undefined; secretRef?: string | undefined; }, { env?: string | undefined; secretRef?: string | undefined; }>Storage Secret Ref 的运行时 Schema。
storageSpecDefinitions常量const storageSpecDefinitions: readonly [SpecSchemaDefinition<StorageProviderProfile>, SpecSchemaDefinition<StorageTopologySpec>]index 模块导出的 Storage Spec Definitions 常量。
storageSpecJsonSchemas常量const storageSpecJsonSchemas: Record<string, JsonSchema>index 模块导出的 Storage Spec JSON Schemas 常量。
storageTopologySpecDefinition常量const storageTopologySpecDefinition: SpecSchemaDefinition<StorageTopologySpec>Storage Topology Spec 的运行时校验入口,组合 Parser、Example 与 JSON Schema。
storageTopologySpecExample常量const storageTopologySpecExample: StorageTopologySpecStorage Topology Spec 的有效示例值。
storageTopologySpecJsonSchema常量const storageTopologySpecJsonSchema: JsonSchemaStorage Topology Spec 的 JSON Schema。
storageTopologySpecSchema常量const storageTopologySpecSchema: z.ZodObject<{ id: z.ZodString; version: z.ZodString; } & { name: z.ZodOptional<z.ZodString>; description: z.ZodOptional<z.ZodString>; owner: z.ZodOptional<z.ZodString>; tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>; createdAt: z.ZodOptional<z.ZodString>; updatedAt: z.ZodOptional<z.ZodString>; } & { providers: z.ZodArray<z.ZodObject<{ id: z.ZodString; version: z.ZodString; } ...Storage Topology Spec 的运行时 Schema。
assertStorageCapability函数assertStorageCapability(profile: StorageProviderProfile, capability: StorageCapability): voidAssert Storage Capability 函数,提供 1 个公开调用签名;参数与返回类型见下表。
createChromaStorageProfile函数createChromaStorageProfile(input?: Omit<Parameters<typeof createVectorStorageProfile>[0], "engine">): StorageProviderProfileCreate Chroma Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。
createFileArtifactStorageProfile函数createFileArtifactStorageProfile(input?: { id?: string; uri?: string; rootPath?: string; }): StorageProviderProfileCreate File Artifact Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。
createKafkaStorageProfile函数createKafkaStorageProfile(input?: { id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; tls?: boolean; region?: string; }): StorageProviderProfileCreate Kafka Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。
createLocalVectorStorageProfile函数createLocalVectorStorageProfile(input?: { id?: string; uri?: string; database?: string; }): StorageProviderProfileCreate Local Vector Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。
createMongoStorageProfile函数createMongoStorageProfile(input?: { id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; }): StorageProviderProfileCreate Mongo Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。
createPineconeStorageProfile函数createPineconeStorageProfile(input?: Omit<Parameters<typeof createVectorStorageProfile>[0], "engine">): StorageProviderProfileCreate Pinecone Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。
createQdrantStorageProfile函数createQdrantStorageProfile(input?: Omit<Parameters<typeof createVectorStorageProfile>[0], "engine">): StorageProviderProfileCreate Qdrant Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。
createRedisStorageProfile函数createRedisStorageProfile(input?: { id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; }): StorageProviderProfileCreate Redis Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。
createSQLiteStorageProfile函数createSQLiteStorageProfile(input?: { id?: string; role?: Extract<StorageRole, "source_of_truth" | "event_log">; uri?: string; database?: string; }): StorageProviderProfileCreate SQLite Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。
createVectorStorageProfile函数createVectorStorageProfile(input: { engine: VectorStorageEngine; id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; region?: string; apiKeyEnv?: string; options?: Record<string, unknown>; }): StorageProviderProfileCreate Vector Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。
createWeaviateStorageProfile函数createWeaviateStorageProfile(input?: Omit<Parameters<typeof createVectorStorageProfile>[0], "engine">): StorageProviderProfileCreate Weaviate Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。
inferStorageDeployment函数inferStorageDeployment(profile: StorageProviderProfile, uri?: string): StorageDeploymentModeInfer Storage Deployment 函数,提供 1 个公开调用签名;参数与返回类型见下表。
redactStorageConnection函数redactStorageConnection(connection: ResolvedStorageConnection): ResolvedStorageConnectionRedact Storage Connection 函数,提供 1 个公开调用签名;参数与返回类型见下表。
resolveStorageConnection函数resolveStorageConnection(profile: StorageProviderProfile, env?: EnvSource): ResolvedStorageConnectionResolve Storage Connection 函数,提供 1 个公开调用签名;参数与返回类型见下表。
validateStorageProviderProfile函数validateStorageProviderProfile(input: unknown): StorageProviderProfileValidate Storage Provider Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。
validateStorageTopologySpec函数validateStorageTopologySpec(input: unknown): StorageTopologySpecValidate Storage Topology Spec 函数,提供 1 个公开调用签名;参数与返回类型见下表。
ResolvedStorageConnection接口interface ResolvedStorageConnectionResolved Storage Connection 接口,共包含 12 个公开字段或方法。
StorageConnectionSpec接口interface StorageConnectionSpecStorage Connection Spec 接口,共包含 11 个公开字段或方法。
StorageProviderProfile接口interface StorageProviderProfile extends VersionedSpec, SpecMetadataStorage Provider Profile 接口,共包含 17 个公开字段或方法。
StorageSecretRef接口interface StorageSecretRefStorage Secret Ref 接口,共包含 2 个公开字段或方法。
StorageTopologySpec接口interface StorageTopologySpec extends VersionedSpec, SpecMetadataStorage Topology Spec 接口,共包含 10 个公开字段或方法。
EnvSource类型type EnvSource = Record<string, string | undefined>Env Source 公共类型别名;完整类型表达式见声明。
StorageCapability类型type StorageCapability = 'structured' | 'transactions' | 'events' | 'cache' | 'queue' | 'pubsub' | 'streams' | 'vector_search' | 'metadata_filter' | 'artifact_bytes' | 'managed_backup' | 'tls' | 'multi_region'Storage Capability 公共类型别名;完整类型表达式见声明。
StorageDeploymentMode类型type StorageDeploymentMode = 'local' | 'self_hosted' | 'managed' | 'cloud'Storage Deployment Mode 公共类型别名;完整类型表达式见声明。
StorageEngine类型type StorageEngine = 'sqlite' | 'postgres' | 'mysql' | 'mongodb' | 'redis' | 'kafka' | 'local-vector' | 'pgvector' | 'qdrant' | 'milvus' | 'chroma' | 'pinecone' | 'weaviate' | 'file-artifact' | 's3' | 'gcs' | 'azure-blob' | 'json'Storage Engine 公共类型别名;完整类型表达式见声明。
StorageProviderKind类型type StorageProviderKind = 'relational' | 'document' | 'messaging' | 'cache' | 'vector' | 'object' | 'event' | 'hybrid'Storage Provider Kind 公共类型别名;完整类型表达式见声明。
StorageRole类型type StorageRole = 'source_of_truth' | 'event_log' | 'semantic_index' | 'cache' | 'message_queue' | 'artifact_store' | 'document_store' | 'hybrid_memory'Storage Role 公共类型别名;完整类型表达式见声明。
VectorStorageEngine类型type VectorStorageEngine = Extract<StorageEngine, 'pgvector' | 'qdrant' | 'milvus' | 'chroma' | 'pinecone' | 'weaviate'>Vector Storage Engine 公共类型别名;完整类型表达式见声明。

storageCapabilitySchema

Storage Capability 的运行时 Schema。

  • 种类: 常量
  • 导入: import { storageCapabilitySchema } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageCapabilitySchema: z.ZodEnum<["structured", "transactions", "events", "cache", "queue", "pubsub", "streams", "vector_search", "metadata_filter", "artifact_bytes", "managed_backup", "tls", "multi_region"]>;

storageConnectionSpecSchema

Storage Connection Spec 的运行时 Schema。

  • 种类: 常量
  • 导入: import { storageConnectionSpecSchema } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageConnectionSpecSchema: z.ZodObject<{ uri: z.ZodOptional<z.ZodString>; uriEnv: z.ZodOptional<z.ZodString>; host: z.ZodOptional<z.ZodString>; port: z.ZodOptional<z.ZodNumber>; database: z.ZodOptional<z.ZodString>; username: z.ZodOptional<z.ZodString>; usernameEnv: z.ZodOptional<z.ZodString>; passwordEnv: z.ZodOptional<z.ZodString>; tls: z.ZodOptional<z.ZodBoolean>; region: z.ZodOptional<z.ZodString>; options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>; }, "strip", z.ZodTypeAny, { tls?: boolean | undefined; options?: Record<string, unknown> | undefined; uri?: string | undefined; uriEnv?: string | undefined; host?: string | undefined; port?: number | undefined; database?: string | undefined; username?: string | undefined; usernameEnv?: string | undefined; passwordEnv?: string | undefined; region?: string | undefined; }, { tls?: boolean | undefined; options?: Record<string, unknown> | undefined; uri?: string | undefined; uriEnv?: string | undefined; host?: string | undefined; port?: number | undefined; database?: string | undefined; username?: string | undefined; usernameEnv?: string | undefined; passwordEnv?: string | undefined; region?: string | undefined; }>;

storageDeploymentModeSchema

Storage Deployment Mode 的运行时 Schema。

  • 种类: 常量
  • 导入: import { storageDeploymentModeSchema } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageDeploymentModeSchema: z.ZodEnum<["local", "self_hosted", "managed", "cloud"]>;

storageEngineSchema

Storage Engine 的运行时 Schema。

  • 种类: 常量
  • 导入: import { storageEngineSchema } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageEngineSchema: z.ZodEnum<["sqlite", "postgres", "mysql", "mongodb", "redis", "kafka", "local-vector", "pgvector", "qdrant", "milvus", "chroma", "pinecone", "weaviate", "file-artifact", "s3", "gcs", "azure-blob", "json"]>;

storageProviderKindSchema

Storage Provider Kind 的运行时 Schema。

  • 种类: 常量
  • 导入: import { storageProviderKindSchema } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageProviderKindSchema: z.ZodEnum<["relational", "document", "messaging", "cache", "vector", "object", "event", "hybrid"]>;

storageProviderProfileDefinition

index 模块导出的 Storage Provider Profile Definition 常量。

  • 种类: 常量
  • 导入: import { storageProviderProfileDefinition } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageProviderProfileDefinition: SpecSchemaDefinition<StorageProviderProfile>;

storageProviderProfileExample

Storage Provider Profile 的有效示例值。

  • 种类: 常量
  • 导入: import { storageProviderProfileExample } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageProviderProfileExample: StorageProviderProfile;

storageProviderProfileJsonSchema

Storage Provider Profile 的 JSON Schema。

  • 种类: 常量
  • 导入: import { storageProviderProfileJsonSchema } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageProviderProfileJsonSchema: JsonSchema;

storageProviderProfileSchema

Storage Provider Profile 的运行时 Schema。

  • 种类: 常量
  • 导入: import { storageProviderProfileSchema } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
// 精确类型由包入口解析;完整编译器展开定义见源码链接。
export declare const storageProviderProfileSchema: (typeof import('@codesoul-co/hypha-storage'))['storageProviderProfileSchema'];

该常量的编译器展开类型已压缩;它的公共名称、顶层类型与源码位置仍保留在本条目中。相关输入/输出字段请使用同模块导出的接口、类型或 Runtime Schema。

storageRoleSchema

Storage Role 的运行时 Schema。

  • 种类: 常量
  • 导入: import { storageRoleSchema } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageRoleSchema: z.ZodEnum<["source_of_truth", "event_log", "semantic_index", "cache", "message_queue", "artifact_store", "document_store", "hybrid_memory"]>;

storageSecretRefSchema

Storage Secret Ref 的运行时 Schema。

  • 种类: 常量
  • 导入: import { storageSecretRefSchema } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageSecretRefSchema: z.ZodObject<{ env: z.ZodOptional<z.ZodString>; secretRef: z.ZodOptional<z.ZodString>; }, "strip", z.ZodTypeAny, { env?: string | undefined; secretRef?: string | undefined; }, { env?: string | undefined; secretRef?: string | undefined; }>;

storageSpecDefinitions

index 模块导出的 Storage Spec Definitions 常量。

  • 种类: 常量
  • 导入: import { storageSpecDefinitions } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageSpecDefinitions: readonly [SpecSchemaDefinition<StorageProviderProfile>, SpecSchemaDefinition<StorageTopologySpec>];

storageSpecJsonSchemas

index 模块导出的 Storage Spec JSON Schemas 常量。

  • 种类: 常量
  • 导入: import { storageSpecJsonSchemas } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageSpecJsonSchemas: Record<string, JsonSchema>;

storageTopologySpecDefinition

Storage Topology Spec 的运行时校验入口,组合 Parser、Example 与 JSON Schema。

  • 种类: 常量
  • 导入: import { storageTopologySpecDefinition } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageTopologySpecDefinition: SpecSchemaDefinition<StorageTopologySpec>;

storageTopologySpecExample

Storage Topology Spec 的有效示例值。

  • 种类: 常量
  • 导入: import { storageTopologySpecExample } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageTopologySpecExample: StorageTopologySpec;

storageTopologySpecJsonSchema

Storage Topology Spec 的 JSON Schema。

  • 种类: 常量
  • 导入: import { storageTopologySpecJsonSchema } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare const storageTopologySpecJsonSchema: JsonSchema;

storageTopologySpecSchema

Storage Topology Spec 的运行时 Schema。

  • 种类: 常量
  • 导入: import { storageTopologySpecSchema } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
// 精确类型由包入口解析;完整编译器展开定义见源码链接。
export declare const storageTopologySpecSchema: (typeof import('@codesoul-co/hypha-storage'))['storageTopologySpecSchema'];

该常量的编译器展开类型已压缩;它的公共名称、顶层类型与源码位置仍保留在本条目中。相关输入/输出字段请使用同模块导出的接口、类型或 Runtime Schema。

assertStorageCapability

Assert Storage Capability 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { assertStorageCapability } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function assertStorageCapability(profile: StorageProviderProfile, capability: StorageCapability): void;

调用签名

text
assertStorageCapability(profile: StorageProviderProfile, capability: StorageCapability): void

参数

参数类型必需说明
profileStorageProviderProfile必需参数;接受的值由类型列定义。
capabilityStorageCapability必需参数;接受的值由类型列定义。

返回值

  • 类型: void
  • 说明: 不返回值。

createChromaStorageProfile

Create Chroma Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { createChromaStorageProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function createChromaStorageProfile(input?: Omit<Parameters<typeof createVectorStorageProfile>[0], 'engine'>): StorageProviderProfile;

调用签名

text
createChromaStorageProfile(input?: Omit<Parameters<typeof createVectorStorageProfile>[0], "engine">): StorageProviderProfile

参数

参数类型必需说明
inputOmit<{ engine: VectorStorageEngine; id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; region?: string; apiKeyEnv?: string; options?: Record<string, unknown>; }, "engine">可选参数;接受的值由类型列定义。

返回值

  • 类型: StorageProviderProfile
  • 说明: 返回值契约由上述类型定义。

createFileArtifactStorageProfile

Create File Artifact Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { createFileArtifactStorageProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function createFileArtifactStorageProfile(input?: {
    id?: string;
    uri?: string;
    rootPath?: string;
}): StorageProviderProfile;

调用签名

text
createFileArtifactStorageProfile(input?: { id?: string; uri?: string; rootPath?: string; }): StorageProviderProfile

参数

参数类型必需说明
input{ id?: string; uri?: string; rootPath?: string; }可选参数;接受的值由类型列定义。

返回值

  • 类型: StorageProviderProfile
  • 说明: 返回值契约由上述类型定义。

createKafkaStorageProfile

Create Kafka Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { createKafkaStorageProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function createKafkaStorageProfile(input?: {
    id?: string;
    deployment?: StorageDeploymentMode;
    uriEnv?: string;
    uri?: string;
    host?: string;
    port?: number;
    tls?: boolean;
    region?: string;
}): StorageProviderProfile;

调用签名

text
createKafkaStorageProfile(input?: { id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; tls?: boolean; region?: string; }): StorageProviderProfile

参数

参数类型必需说明
input{ id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; tls?: boolean; region?: string; }可选参数;接受的值由类型列定义。

返回值

  • 类型: StorageProviderProfile
  • 说明: 返回值契约由上述类型定义。

createLocalVectorStorageProfile

Create Local Vector Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { createLocalVectorStorageProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function createLocalVectorStorageProfile(input?: {
    id?: string;
    uri?: string;
    database?: string;
}): StorageProviderProfile;

调用签名

text
createLocalVectorStorageProfile(input?: { id?: string; uri?: string; database?: string; }): StorageProviderProfile

参数

参数类型必需说明
input{ id?: string; uri?: string; database?: string; }可选参数;接受的值由类型列定义。

返回值

  • 类型: StorageProviderProfile
  • 说明: 返回值契约由上述类型定义。

createMongoStorageProfile

Create Mongo Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { createMongoStorageProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function createMongoStorageProfile(input?: {
    id?: string;
    deployment?: StorageDeploymentMode;
    uriEnv?: string;
    uri?: string;
    host?: string;
    port?: number;
    database?: string;
    tls?: boolean;
}): StorageProviderProfile;

调用签名

text
createMongoStorageProfile(input?: { id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; }): StorageProviderProfile

参数

参数类型必需说明
input{ id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; }可选参数;接受的值由类型列定义。

返回值

  • 类型: StorageProviderProfile
  • 说明: 返回值契约由上述类型定义。

createPineconeStorageProfile

Create Pinecone Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { createPineconeStorageProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function createPineconeStorageProfile(input?: Omit<Parameters<typeof createVectorStorageProfile>[0], 'engine'>): StorageProviderProfile;

调用签名

text
createPineconeStorageProfile(input?: Omit<Parameters<typeof createVectorStorageProfile>[0], "engine">): StorageProviderProfile

参数

参数类型必需说明
inputOmit<{ engine: VectorStorageEngine; id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; region?: string; apiKeyEnv?: string; options?: Record<string, unknown>; }, "engine">可选参数;接受的值由类型列定义。

返回值

  • 类型: StorageProviderProfile
  • 说明: 返回值契约由上述类型定义。

createQdrantStorageProfile

Create Qdrant Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { createQdrantStorageProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function createQdrantStorageProfile(input?: Omit<Parameters<typeof createVectorStorageProfile>[0], 'engine'>): StorageProviderProfile;

调用签名

text
createQdrantStorageProfile(input?: Omit<Parameters<typeof createVectorStorageProfile>[0], "engine">): StorageProviderProfile

参数

参数类型必需说明
inputOmit<{ engine: VectorStorageEngine; id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; region?: string; apiKeyEnv?: string; options?: Record<string, unknown>; }, "engine">可选参数;接受的值由类型列定义。

返回值

  • 类型: StorageProviderProfile
  • 说明: 返回值契约由上述类型定义。

createRedisStorageProfile

Create Redis Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { createRedisStorageProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function createRedisStorageProfile(input?: {
    id?: string;
    deployment?: StorageDeploymentMode;
    uriEnv?: string;
    uri?: string;
    host?: string;
    port?: number;
    database?: string;
    tls?: boolean;
}): StorageProviderProfile;

调用签名

text
createRedisStorageProfile(input?: { id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; }): StorageProviderProfile

参数

参数类型必需说明
input{ id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; }可选参数;接受的值由类型列定义。

返回值

  • 类型: StorageProviderProfile
  • 说明: 返回值契约由上述类型定义。

createSQLiteStorageProfile

Create SQLite Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { createSQLiteStorageProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function createSQLiteStorageProfile(input?: {
    id?: string;
    role?: Extract<StorageRole, 'source_of_truth' | 'event_log'>;
    uri?: string;
    database?: string;
}): StorageProviderProfile;

调用签名

text
createSQLiteStorageProfile(input?: { id?: string; role?: Extract<StorageRole, "source_of_truth" | "event_log">; uri?: string; database?: string; }): StorageProviderProfile

参数

参数类型必需说明
input{ id?: string; role?: Extract<StorageRole, "source_of_truth" | "event_log">; uri?: string; database?: string; }可选参数;接受的值由类型列定义。

返回值

  • 类型: StorageProviderProfile
  • 说明: 返回值契约由上述类型定义。

createVectorStorageProfile

Create Vector Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { createVectorStorageProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function createVectorStorageProfile(input: {
    engine: VectorStorageEngine;
    id?: string;
    deployment?: StorageDeploymentMode;
    uriEnv?: string;
    uri?: string;
    host?: string;
    port?: number;
    database?: string;
    tls?: boolean;
    region?: string;
    apiKeyEnv?: string;
    options?: Record<string, unknown>;
}): StorageProviderProfile;

调用签名

text
createVectorStorageProfile(input: { engine: VectorStorageEngine; id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; region?: string; apiKeyEnv?: string; options?: Record<string, unknown>; }): StorageProviderProfile

参数

参数类型必需说明
input{ engine: VectorStorageEngine; id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; region?: string; apiKeyEnv?: string; options?: Record<string, unknown>; }必需参数;接受的值由类型列定义。

返回值

  • 类型: StorageProviderProfile
  • 说明: 返回值契约由上述类型定义。

createWeaviateStorageProfile

Create Weaviate Storage Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { createWeaviateStorageProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function createWeaviateStorageProfile(input?: Omit<Parameters<typeof createVectorStorageProfile>[0], 'engine'>): StorageProviderProfile;

调用签名

text
createWeaviateStorageProfile(input?: Omit<Parameters<typeof createVectorStorageProfile>[0], "engine">): StorageProviderProfile

参数

参数类型必需说明
inputOmit<{ engine: VectorStorageEngine; id?: string; deployment?: StorageDeploymentMode; uriEnv?: string; uri?: string; host?: string; port?: number; database?: string; tls?: boolean; region?: string; apiKeyEnv?: string; options?: Record<string, unknown>; }, "engine">可选参数;接受的值由类型列定义。

返回值

  • 类型: StorageProviderProfile
  • 说明: 返回值契约由上述类型定义。

inferStorageDeployment

Infer Storage Deployment 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { inferStorageDeployment } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function inferStorageDeployment(profile: StorageProviderProfile, uri?: string): StorageDeploymentMode;

调用签名

text
inferStorageDeployment(profile: StorageProviderProfile, uri?: string): StorageDeploymentMode

参数

参数类型必需说明
profileStorageProviderProfile必需参数;接受的值由类型列定义。
uristring可选参数;接受的值由类型列定义。

返回值

  • 类型: StorageDeploymentMode
  • 说明: 返回值契约由上述类型定义。

redactStorageConnection

Redact Storage Connection 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { redactStorageConnection } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function redactStorageConnection(connection: ResolvedStorageConnection): ResolvedStorageConnection;

调用签名

text
redactStorageConnection(connection: ResolvedStorageConnection): ResolvedStorageConnection

参数

参数类型必需说明
connectionResolvedStorageConnection必需参数;接受的值由类型列定义。

返回值

  • 类型: ResolvedStorageConnection
  • 说明: 返回值契约由上述类型定义。

resolveStorageConnection

Resolve Storage Connection 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { resolveStorageConnection } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function resolveStorageConnection(profile: StorageProviderProfile, env?: EnvSource): ResolvedStorageConnection;

调用签名

text
resolveStorageConnection(profile: StorageProviderProfile, env?: EnvSource): ResolvedStorageConnection

参数

参数类型必需说明
profileStorageProviderProfile必需参数;接受的值由类型列定义。
envEnvSource可选参数;接受的值由类型列定义。

返回值

  • 类型: ResolvedStorageConnection
  • 说明: 返回值契约由上述类型定义。

validateStorageProviderProfile

Validate Storage Provider Profile 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { validateStorageProviderProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function validateStorageProviderProfile(input: unknown): StorageProviderProfile;

调用签名

text
validateStorageProviderProfile(input: unknown): StorageProviderProfile

参数

参数类型必需说明
inputunknown必需参数;接受的值由类型列定义。

返回值

  • 类型: StorageProviderProfile
  • 说明: 返回值契约由上述类型定义。

validateStorageTopologySpec

Validate Storage Topology Spec 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { validateStorageTopologySpec } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export declare function validateStorageTopologySpec(input: unknown): StorageTopologySpec;

调用签名

text
validateStorageTopologySpec(input: unknown): StorageTopologySpec

参数

参数类型必需说明
inputunknown必需参数;接受的值由类型列定义。

返回值

  • 类型: StorageTopologySpec
  • 说明: 返回值契约由上述类型定义。

ResolvedStorageConnection

Resolved Storage Connection 接口,共包含 12 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ResolvedStorageConnection } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export interface ResolvedStorageConnection {
    profileId: string;
    engine: StorageEngine;
    deployment: StorageDeploymentMode;
    uri?: string;
    uriSource?: 'env' | 'inline' | 'composed';
    host?: string;
    port?: number;
    database?: string;
    username?: string;
    tls?: boolean;
    region?: string;
    options?: Record<string, unknown>;
}

契约成员

成员种类签名说明
database属性database?: string公开属性;类型、只读和可选状态以签名列为准。
deployment属性deployment: StorageDeploymentMode公开属性;类型、只读和可选状态以签名列为准。
engine属性engine: StorageEngine公开属性;类型、只读和可选状态以签名列为准。
host属性host?: string公开属性;类型、只读和可选状态以签名列为准。
options属性options?: Record<string, unknown>公开属性;类型、只读和可选状态以签名列为准。
port属性port?: number公开属性;类型、只读和可选状态以签名列为准。
profileId属性profileId: string公开属性;类型、只读和可选状态以签名列为准。
region属性region?: string公开属性;类型、只读和可选状态以签名列为准。
tls属性tls?: boolean公开属性;类型、只读和可选状态以签名列为准。
uri属性uri?: string公开属性;类型、只读和可选状态以签名列为准。
uriSource属性uriSource?: "env" | "inline" | "composed"公开属性;类型、只读和可选状态以签名列为准。
username属性username?: string公开属性;类型、只读和可选状态以签名列为准。

StorageConnectionSpec

Storage Connection Spec 接口,共包含 11 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { StorageConnectionSpec } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export interface StorageConnectionSpec {
    uri?: string;
    uriEnv?: string;
    host?: string;
    port?: number;
    database?: string;
    username?: string;
    usernameEnv?: string;
    passwordEnv?: string;
    tls?: boolean;
    region?: string;
    options?: Record<string, unknown>;
}

契约成员

成员种类签名说明
database属性database?: string公开属性;类型、只读和可选状态以签名列为准。
host属性host?: string公开属性;类型、只读和可选状态以签名列为准。
options属性options?: Record<string, unknown>公开属性;类型、只读和可选状态以签名列为准。
passwordEnv属性passwordEnv?: string公开属性;类型、只读和可选状态以签名列为准。
port属性port?: number公开属性;类型、只读和可选状态以签名列为准。
region属性region?: string公开属性;类型、只读和可选状态以签名列为准。
tls属性tls?: boolean公开属性;类型、只读和可选状态以签名列为准。
uri属性uri?: string公开属性;类型、只读和可选状态以签名列为准。
uriEnv属性uriEnv?: string公开属性;类型、只读和可选状态以签名列为准。
username属性username?: string公开属性;类型、只读和可选状态以签名列为准。
usernameEnv属性usernameEnv?: string公开属性;类型、只读和可选状态以签名列为准。

StorageProviderProfile

Storage Provider Profile 接口,共包含 17 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { StorageProviderProfile } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export interface StorageProviderProfile extends VersionedSpec, SpecMetadata {
    kind: StorageProviderKind;
    engine: StorageEngine;
    deployment: StorageDeploymentMode;
    role: StorageRole;
    connection?: StorageConnectionSpec;
    capabilities?: StorageCapability[];
    consistency?: 'strong' | 'eventual';
    secrets?: {
        apiKey?: StorageSecretRef;
        username?: StorageSecretRef;
        password?: StorageSecretRef;
        token?: StorageSecretRef;
    };
    configSchema?: JsonSchema;
}

契约成员

成员种类签名说明
capabilities属性capabilities?: StorageCapability[]公开属性;类型、只读和可选状态以签名列为准。
configSchema属性configSchema?: JsonSchema公开属性;类型、只读和可选状态以签名列为准。
connection属性connection?: StorageConnectionSpec公开属性;类型、只读和可选状态以签名列为准。
consistency属性consistency?: "strong" | "eventual"公开属性;类型、只读和可选状态以签名列为准。
createdAt属性createdAt?: string公开属性;类型、只读和可选状态以签名列为准。
deployment属性deployment: StorageDeploymentMode公开属性;类型、只读和可选状态以签名列为准。
description属性description?: string公开属性;类型、只读和可选状态以签名列为准。
engine属性engine: StorageEngine公开属性;类型、只读和可选状态以签名列为准。
id属性id: string公开属性;类型、只读和可选状态以签名列为准。
kind属性kind: StorageProviderKind公开属性;类型、只读和可选状态以签名列为准。
name属性name?: string公开属性;类型、只读和可选状态以签名列为准。
owner属性owner?: string公开属性;类型、只读和可选状态以签名列为准。
role属性role: StorageRole公开属性;类型、只读和可选状态以签名列为准。
secrets属性secrets?: { apiKey?: StorageSecretRef; username?: StorageSecretRef; password?: StorageSecretRef; token?: StorageSecretRef; }公开属性;类型、只读和可选状态以签名列为准。
tags属性tags?: string[]公开属性;类型、只读和可选状态以签名列为准。
updatedAt属性updatedAt?: string公开属性;类型、只读和可选状态以签名列为准。
version属性version: string公开属性;类型、只读和可选状态以签名列为准。

StorageSecretRef

Storage Secret Ref 接口,共包含 2 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { StorageSecretRef } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export interface StorageSecretRef {
    env?: string;
    secretRef?: string;
}

契约成员

成员种类签名说明
env属性env?: string公开属性;类型、只读和可选状态以签名列为准。
secretRef属性secretRef?: string公开属性;类型、只读和可选状态以签名列为准。

StorageTopologySpec

Storage Topology Spec 接口,共包含 10 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { StorageTopologySpec } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export interface StorageTopologySpec extends VersionedSpec, SpecMetadata {
    providers: StorageProviderProfile[];
    defaults: {
        relationalRef?: SpecRef;
        documentRef?: SpecRef;
        messagingRef?: SpecRef;
        cacheRef?: SpecRef;
        vectorRef?: SpecRef;
        artifactRef?: SpecRef;
        eventRef?: SpecRef;
        memoryRef?: SpecRef;
    };
}

契约成员

成员种类签名说明
createdAt属性createdAt?: string公开属性;类型、只读和可选状态以签名列为准。
defaults属性defaults: { relationalRef?: SpecRef; documentRef?: SpecRef; messagingRef?: SpecRef; cacheRef?: SpecRef; vectorRef?: SpecRef; artifactRef?: SpecRef; eventRef?: SpecRef; memoryRef?: SpecRef; }公开属性;类型、只读和可选状态以签名列为准。
description属性description?: string公开属性;类型、只读和可选状态以签名列为准。
id属性id: string公开属性;类型、只读和可选状态以签名列为准。
name属性name?: string公开属性;类型、只读和可选状态以签名列为准。
owner属性owner?: string公开属性;类型、只读和可选状态以签名列为准。
providers属性providers: StorageProviderProfile[]公开属性;类型、只读和可选状态以签名列为准。
tags属性tags?: string[]公开属性;类型、只读和可选状态以签名列为准。
updatedAt属性updatedAt?: string公开属性;类型、只读和可选状态以签名列为准。
version属性version: string公开属性;类型、只读和可选状态以签名列为准。

EnvSource

Env Source 公共类型别名;完整类型表达式见声明。

  • 种类: 类型
  • 导入: import type { EnvSource } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export type EnvSource = Record<string, string | undefined>;

StorageCapability

Storage Capability 公共类型别名;完整类型表达式见声明。

  • 种类: 类型
  • 导入: import type { StorageCapability } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export type StorageCapability = 'structured' | 'transactions' | 'events' | 'cache' | 'queue' | 'pubsub' | 'streams' | 'vector_search' | 'metadata_filter' | 'artifact_bytes' | 'managed_backup' | 'tls' | 'multi_region';

StorageDeploymentMode

Storage Deployment Mode 公共类型别名;完整类型表达式见声明。

  • 种类: 类型
  • 导入: import type { StorageDeploymentMode } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export type StorageDeploymentMode = 'local' | 'self_hosted' | 'managed' | 'cloud';

StorageEngine

Storage Engine 公共类型别名;完整类型表达式见声明。

  • 种类: 类型
  • 导入: import type { StorageEngine } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export type StorageEngine = 'sqlite' | 'postgres' | 'mysql' | 'mongodb' | 'redis' | 'kafka' | 'local-vector' | 'pgvector' | 'qdrant' | 'milvus' | 'chroma' | 'pinecone' | 'weaviate' | 'file-artifact' | 's3' | 'gcs' | 'azure-blob' | 'json';

StorageProviderKind

Storage Provider Kind 公共类型别名;完整类型表达式见声明。

  • 种类: 类型
  • 导入: import type { StorageProviderKind } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export type StorageProviderKind = 'relational' | 'document' | 'messaging' | 'cache' | 'vector' | 'object' | 'event' | 'hybrid';

StorageRole

Storage Role 公共类型别名;完整类型表达式见声明。

  • 种类: 类型
  • 导入: import type { StorageRole } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export type StorageRole = 'source_of_truth' | 'event_log' | 'semantic_index' | 'cache' | 'message_queue' | 'artifact_store' | 'document_store' | 'hybrid_memory';

VectorStorageEngine

Vector Storage Engine 公共类型别名;完整类型表达式见声明。

  • 种类: 类型
  • 导入: import type { VectorStorageEngine } from '@codesoul-co/hypha-storage';
  • 源码模块: index

声明

text
export type VectorStorageEngine = Extract<StorageEngine, 'pgvector' | 'qdrant' | 'milvus' | 'chroma' | 'pinecone' | 'weaviate'>;