@palbase/backend 22.0.1 → 22.1.0

package/dist/{endpoint-B0LpZixz.d.cts → endpoint-BVT6jcVW.d.cts}

@@ -1562,6 +1562,22 @@ interface PalbaseFlagsClient {
  * await Realtime.broadcast("room:42", "message", { text, from: user.id });
  */
 interface PalbaseRealtimeClient {
+    /**
+     * A channel's SHARED STATE — a keyed map every subscriber sees, including
+     * the ones that join later.
+     *
+     * That is the whole difference from `broadcast`: a broadcast reaches whoever
+     * is listening at that instant, and a client connecting a second afterwards
+     * learns nothing until the next one. State is handed to every joiner in the
+     * snapshot they get, so "the score is 3-1" or "this flag is now on" arrives
+     * even for a client that was not there when it changed.
+     */
+    state: {
+        /** Write one entry. Fire-and-forget, like `broadcast`. */
+        set(topic: string, key: string, value: Record<string, unknown>): Promise<PalbaseResult<void>>;
+        /** Remove one entry. */
+        clear(topic: string, key: string): Promise<PalbaseResult<void>>;
+    };
     /**
      * Broadcast `event` with `payload` to everyone subscribed to `channel`.
      *
@@ -1811,6 +1827,15 @@ interface DBOps {
     update(table: string, id: string, data: Record<string, unknown>): Promise<Record<string, unknown> | null>;
     delete(table: string, id: string): Promise<void>;
     findById(table: string, id: string): Promise<Record<string, unknown> | null>;
+    /** Hibrit arama (FR-013/014) — tek SQL, RRF; engine implement eder (T017). */
+    search(table: string, params?: {
+        query?: string;
+        vector?: number[];
+        where?: Record<string, unknown>;
+        limit?: number;
+        using?: string;
+        mode?: "hybrid" | "text" | "vector";
+    }): Promise<Record<string, unknown>[]>;
     findMany(table: string, query?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
 }
 /** Database client interface injected into endpoint context. */
@@ -1963,19 +1988,26 @@ interface PalbaseDocsClient {
 }
 /** Calling-client metadata, derived from request headers.
  *
- * Populated from the `X-Palbase-*-Version` / platform headers the client SDKs
- * send. All fields are nullable: a request may come from a non-SDK caller
- * (curl, server-to-server) that sends none of them. The semver comparison
- * helpers (`appVersionAtLeast`, …) arrive in Phase 2 — Phase 1 surfaces only
- * the raw data fields. */
+ * Every header is named here, because the previous version of this comment named
+ * only two of the four and the next reader invented `X-Palbase-Platform` for the
+ * third. The four are canonical across the platform — the same names the Go
+ * side reads in user-flags/internal/middleware/clientcontext.go — and the deploy
+ * gate REFUSES an `@Headers` schema that declares an `x-palbase-*` key, which
+ * makes `@Client()` the only sanctioned way to read them.
+ *
+ * All fields are nullable: a request may come from a non-SDK caller (curl,
+ * server-to-server) that sends none of them. Note that the web SDK does not
+ * send `X-Palbase-Sdk-Version` at all, so `sdkVersion` is null for every browser
+ * caller. The semver comparison helpers (`appVersionAtLeast`, …) arrive in
+ * Phase 2 — Phase 1 surfaces only the raw data fields. */
 interface ClientInfo {
     /** Palbase SDK version (`X-Palbase-Sdk-Version`), or null. */
     sdkVersion: string | null;
     /** Calling app's own version (`X-Palbase-Client-Version`), or null. */
     appVersion: string | null;
-    /** Platform identifier (e.g. "ios", "android", "web"), or null. */
+    /** Platform identifier (`X-Platform`, e.g. "ios", "android", "web"), or null. */
     platform: string | null;
-    /** OS version string, or null. */
+    /** OS version string (`X-OS-Version`), or null. */
     osVersion: string | null;
 }
 /** Palbase module clients, as a structural bundle.

package/dist/{endpoint-B0LpZixz.d.ts → endpoint-BVT6jcVW.d.ts}

@@ -1562,6 +1562,22 @@ interface PalbaseFlagsClient {
  * await Realtime.broadcast("room:42", "message", { text, from: user.id });
  */
 interface PalbaseRealtimeClient {
+    /**
+     * A channel's SHARED STATE — a keyed map every subscriber sees, including
+     * the ones that join later.
+     *
+     * That is the whole difference from `broadcast`: a broadcast reaches whoever
+     * is listening at that instant, and a client connecting a second afterwards
+     * learns nothing until the next one. State is handed to every joiner in the
+     * snapshot they get, so "the score is 3-1" or "this flag is now on" arrives
+     * even for a client that was not there when it changed.
+     */
+    state: {
+        /** Write one entry. Fire-and-forget, like `broadcast`. */
+        set(topic: string, key: string, value: Record<string, unknown>): Promise<PalbaseResult<void>>;
+        /** Remove one entry. */
+        clear(topic: string, key: string): Promise<PalbaseResult<void>>;
+    };
     /**
      * Broadcast `event` with `payload` to everyone subscribed to `channel`.
      *
@@ -1811,6 +1827,15 @@ interface DBOps {
     update(table: string, id: string, data: Record<string, unknown>): Promise<Record<string, unknown> | null>;
     delete(table: string, id: string): Promise<void>;
     findById(table: string, id: string): Promise<Record<string, unknown> | null>;
+    /** Hibrit arama (FR-013/014) — tek SQL, RRF; engine implement eder (T017). */
+    search(table: string, params?: {
+        query?: string;
+        vector?: number[];
+        where?: Record<string, unknown>;
+        limit?: number;
+        using?: string;
+        mode?: "hybrid" | "text" | "vector";
+    }): Promise<Record<string, unknown>[]>;
     findMany(table: string, query?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
 }
 /** Database client interface injected into endpoint context. */
@@ -1963,19 +1988,26 @@ interface PalbaseDocsClient {
 }
 /** Calling-client metadata, derived from request headers.
  *
- * Populated from the `X-Palbase-*-Version` / platform headers the client SDKs
- * send. All fields are nullable: a request may come from a non-SDK caller
- * (curl, server-to-server) that sends none of them. The semver comparison
- * helpers (`appVersionAtLeast`, …) arrive in Phase 2 — Phase 1 surfaces only
- * the raw data fields. */
+ * Every header is named here, because the previous version of this comment named
+ * only two of the four and the next reader invented `X-Palbase-Platform` for the
+ * third. The four are canonical across the platform — the same names the Go
+ * side reads in user-flags/internal/middleware/clientcontext.go — and the deploy
+ * gate REFUSES an `@Headers` schema that declares an `x-palbase-*` key, which
+ * makes `@Client()` the only sanctioned way to read them.
+ *
+ * All fields are nullable: a request may come from a non-SDK caller (curl,
+ * server-to-server) that sends none of them. Note that the web SDK does not
+ * send `X-Palbase-Sdk-Version` at all, so `sdkVersion` is null for every browser
+ * caller. The semver comparison helpers (`appVersionAtLeast`, …) arrive in
+ * Phase 2 — Phase 1 surfaces only the raw data fields. */
 interface ClientInfo {
     /** Palbase SDK version (`X-Palbase-Sdk-Version`), or null. */
     sdkVersion: string | null;
     /** Calling app's own version (`X-Palbase-Client-Version`), or null. */
     appVersion: string | null;
-    /** Platform identifier (e.g. "ios", "android", "web"), or null. */
+    /** Platform identifier (`X-Platform`, e.g. "ios", "android", "web"), or null. */
     platform: string | null;
-    /** OS version string, or null. */
+    /** OS version string (`X-OS-Version`), or null. */
     osVersion: string | null;
 }
 /** Palbase module clients, as a structural bundle.