@undefineds.co/xpod 0.2.0 → 0.2.1

package/node_modules/@undefineds.co/drizzle-solid/dist/esm/core/notifications/types.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Solid Notifications Protocol 类型定义
+ * @see https://solid.github.io/notifications/protocol
+ */
+/**
+ * 通知事件类型（Activity Streams 2.0）
+ */
+export type NotificationType = 'Create' | 'Update' | 'Delete' | 'Add' | 'Remove';
+/**
+ * Activity Streams 2.0 Object
+ * 可以是简单的 URI 字符串，也可以是完整的对象（未来扩展）
+ * @see https://www.w3.org/TR/activitystreams-core/#object
+ */
+export type ActivityObject = string | {
+    /** 对象 URI */
+    id: string;
+    /** 对象类型 */
+    type?: string;
+    /** 新数据（未来扩展） */
+    new?: Record<string, unknown>;
+    /** 旧数据（未来扩展） */
+    old?: Record<string, unknown>;
+    /** 其他属性 */
+    [key: string]: unknown;
+};
+/**
+ * Activity Streams 2.0 Activity
+ * @see https://www.w3.org/TR/activitystreams-core/#activities
+ */
+export interface Activity {
+    /** Activity 唯一 ID */
+    id: string;
+    /** Activity 类型 */
+    type: NotificationType;
+    /** 变更的资源（URI 或对象） */
+    object: ActivityObject;
+    /** 目标容器（Add/Remove 时） */
+    target?: string;
+    /** 发布时间（ISO 8601） */
+    published: string;
+    /** 状态 token */
+    state?: string;
+}
+/**
+ * 通知事件（兼容旧接口）
+ * @deprecated 使用 Activity 代替
+ */
+export interface NotificationEvent {
+    /** 事件唯一 ID */
+    id: string;
+    /** 事件类型 */
+    type: NotificationType;
+    /** 变更的资源 URL */
+    object: string;
+    /** 事件发布时间（ISO 8601） */
+    published: string;
+    /** 变更后的资源状态（Turtle 格式，需要 state feature） */
+    state?: string;
+}
+/**
+ * 通道类型
+ */
+export type ChannelType = 'streaming-http' | 'websocket';
+/**
+ * 订阅特性
+ */
+export type SubscriptionFeature = 'state' | 'endAt' | 'rate';
+/**
+ * 订阅选项（旧接口，兼容）
+ */
+export interface SubscribeOptions {
+    /** 通道类型，默认 'streaming-http' (SSE) */
+    channel?: ChannelType;
+    /** 订阅特性 */
+    features?: SubscriptionFeature[];
+    /** 收到通知时的回调 */
+    onNotification: (event: NotificationEvent) => void;
+    /** 发生错误时的回调 */
+    onError?: (error: Error) => void;
+    /** 连接关闭时的回调 */
+    onClose?: () => void;
+    /**
+     * 是否启用自动重连（默认 true）
+     * 当连接断开时（如 xpod node_id 切换），自动重新订阅
+     */
+    autoReconnect?: boolean;
+    /**
+     * 最大重连次数（默认 5）
+     * 设为 0 或 Infinity 表示无限重连
+     */
+    maxReconnectAttempts?: number;
+    /**
+     * 重连延迟基数（默认 1000ms）
+     * 实际延迟 = baseDelay * 2^attempt（指数退避）
+     */
+    reconnectDelayMs?: number;
+    /**
+     * 重连时的回调
+     */
+    onReconnect?: (attempt: number) => void;
+}
+/**
+ * 表订阅选项（新接口，按类型分开）
+ */
+export interface TableSubscribeOptions {
+    /**
+     * 覆盖订阅目标的 IRI（用于订阅其他 Pod 的资源）
+     *
+     * @example
+     * // 订阅自己的 profile（使用 table 的 base）
+     * db.subscribe(profileTable, { onUpdate: ... })
+     *
+     * // 订阅 Alice 的 profile
+     * db.subscribe(profileTable, {
+     *   iri: 'https://alice.pod/profile/card.ttl',
+     *   onUpdate: ...
+     * })
+     */
+    iri?: string;
+    /** 通道类型，默认 'streaming-http' (SSE) */
+    channel?: ChannelType;
+    /** 订阅特性 */
+    features?: SubscriptionFeature[];
+    /** 原始通知回调（服务端通知的原始形态） */
+    onNotification?: (event: NotificationEvent) => void;
+    /** 资源创建时的回调（服务端通知按类型分发） */
+    onCreate?: (activity: Activity) => void | Promise<void>;
+    /** 资源更新时的回调（服务端通知按类型分发） */
+    onUpdate?: (activity: Activity) => void | Promise<void>;
+    /** 资源删除时的回调（服务端通知按类型分发） */
+    onDelete?: (activity: Activity) => void | Promise<void>;
+    /** 添加到容器时的回调（服务端通知按类型分发） */
+    onAdd?: (activity: Activity) => void | Promise<void>;
+    /** 从容器移除时的回调（服务端通知按类型分发） */
+    onRemove?: (activity: Activity) => void | Promise<void>;
+    /** 发生错误时的回调 */
+    onError?: (error: Error) => void;
+    /** 连接关闭时的回调 */
+    onClose?: () => void;
+}
+/**
+ * 订阅句柄
+ */
+export interface Subscription {
+    /** 取消订阅 */
+    unsubscribe(): void;
+    /** 订阅是否活跃 */
+    readonly active: boolean;
+    /** 通道类型 */
+    readonly channel: ChannelType;
+    /** 订阅的主题（资源 URL） */
+    readonly topic: string;
+}
+/**
+ * Notifications 服务发现响应
+ */
+export interface NotificationServiceDescription {
+    /** 订阅端点 URL */
+    subscriptionEndpoint: string;
+    /** 支持的通道类型 */
+    channelTypes: string[];
+    /** 支持的特性 */
+    features?: string[];
+}
+/**
+ * 订阅请求体
+ */
+export interface SubscriptionRequest {
+    '@context': string[];
+    type: string;
+    topic: string;
+    features?: string[];
+}
+/**
+ * 订阅响应体
+ */
+export interface SubscriptionResponse {
+    '@context': string[];
+    id: string;
+    type: string;
+    topic: string;
+    receiveFrom: string;
+    features?: string[];
+}
+/**
+ * Channel 接口（内部使用）
+ */
+export interface NotificationChannel {
+    /** 连接到通知服务 */
+    connect(): Promise<void>;
+    /** 断开连接 */
+    disconnect(): void;
+    /** 是否已连接 */
+    readonly connected: boolean;
+}
+/**
+ * Channel 配置（内部使用）
+ */
+export interface ChannelConfig {
+    /** 接收通知的 URL（WebSocket URL 或 SSE URL） */
+    receiveFrom: string;
+    /** 收到通知时的回调 */
+    onNotification: (event: NotificationEvent) => void;
+    /** 发生错误时的回调 */
+    onError?: (error: Error) => void;
+    /** 连接关闭时的回调 */
+    onClose?: () => void;
+    /** 认证 fetch 函数 */
+    fetch?: typeof fetch;
+}
+/**
+ * 单体订阅选项（用于 subscribeByIri）
+ *
+ * 与容器订阅不同，单体订阅没有 onCreate 回调（实体已存在）
+ */
+export interface EntitySubscribeOptions<TData = unknown> {
+    /** 通道类型，默认 'streaming-http' (SSE) */
+    channel?: ChannelType;
+    /** 订阅特性 */
+    features?: SubscriptionFeature[];
+    /** 数据更新时的回调（收到通知后自动重新获取数据） */
+    onUpdate: (data: TData) => void | Promise<void>;
+    /** 实体删除时的回调 */
+    onDelete?: () => void | Promise<void>;
+    /** 发生错误时的回调（如权限撤销、网络错误） */
+    onError?: (error: Error) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@undefineds.co/drizzle-solid/dist/esm/core/notifications/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/notifications/types.ts"],"names":[],"mappings":"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"}

package/node_modules/@undefineds.co/drizzle-solid/dist/esm/core/notifications/types.js

@@ -0,0 +1,6 @@
+/**
+ * Solid Notifications Protocol 类型定义
+ * @see https://solid.github.io/notifications/protocol
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/node_modules/@undefineds.co/drizzle-solid/dist/esm/core/notifications/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/notifications/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/node_modules/@undefineds.co/drizzle-solid/dist/esm/core/order-by.d.ts

@@ -0,0 +1,9 @@
+import { PodColumnBase } from './schema';
+export interface OrderByExpression {
+    column: PodColumnBase | string;
+    direction: 'asc' | 'desc';
+}
+export declare function asc(column: PodColumnBase | string): OrderByExpression;
+export declare function desc(column: PodColumnBase | string): OrderByExpression;
+export declare function isOrderByExpression(value: unknown): value is OrderByExpression;
+//# sourceMappingURL=order-by.d.ts.map

package/node_modules/@undefineds.co/drizzle-solid/dist/esm/core/order-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-by.d.ts","sourceRoot":"","sources":["../../../src/core/order-by.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC;IAC/B,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,wBAAgB,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,iBAAiB,CAErE;AAED,wBAAgB,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,iBAAiB,CAEtE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAU9E"}

package/node_modules/@undefineds.co/drizzle-solid/dist/esm/core/order-by.js

@@ -0,0 +1,15 @@
+export function asc(column) {
+    return { column, direction: 'asc' };
+}
+export function desc(column) {
+    return { column, direction: 'desc' };
+}
+export function isOrderByExpression(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const candidate = value;
+    return ('column' in candidate
+        && (candidate.direction === 'asc' || candidate.direction === 'desc'));
+}
+//# sourceMappingURL=order-by.js.map

package/node_modules/@undefineds.co/drizzle-solid/dist/esm/core/order-by.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-by.js","sourceRoot":"","sources":["../../../src/core/order-by.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,GAAG,CAAC,MAA8B;IAChD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,MAA8B;IACjD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,KAAmC,CAAC;IACtD,OAAO,CACL,QAAQ,IAAI,SAAS;WAClB,CAAC,SAAS,CAAC,SAAS,KAAK,KAAK,IAAI,SAAS,CAAC,SAAS,KAAK,MAAM,CAAC,CACrE,CAAC;AACJ,CAAC"}