@palbase/backend 22.1.0 → 23.0.0

package/dist/engine/index.d.cts

@@ -1,7 +1,8 @@
-export { A as App, l as AuthVerifier, B as BootRefused, m as CreateAppOptions, E as EgressPolicy, n as EngineConfig, M as ModuleClients, o as RateLimiter, p as RequestDatabase, q as RouteEntry, r as RuntimeHooks, s as ScrubResult, t as SqlDriver, u as SqlTx, v as buildRouteTable, w as createApp, x as createLazyTransaction, y as createOps, z as createRequestDatabase, G as effectiveAuth, H as hostAllowed, I as installEgressFence, J as loadConfig, K as makeMemoryCache, O as matchRoute, Q as quoteIdent, T as scrubSecrets, U as withTables } from '../index-BS1gW4nV.cjs';
-import '../endpoint-BVT6jcVW.cjs';
-import '../db/env.cjs';
+export { A as App, h as AuthVerifier, B as BootRefused, i as CreateAppOptions, E as EgressPolicy, j as EngineConfig, M as ModuleClients, k as RateLimiter, l as RequestDatabase, m as RouteEntry, n as RuntimeHooks, o as ScrubResult, p as SqlDriver, q as SqlTx, r as buildRouteTable, s as createApp, t as createLazyTransaction, u as createOps, v as createRequestDatabase, w as effectiveAuth, x as hostAllowed, y as installEgressFence, z as loadConfig, G as makeMemoryCache, H as matchRoute, I as quoteIdent, J as scrubSecrets, K as withTables } from '../index-E7OscPJT.cjs';
+import '../endpoint-i8TTCohk.cjs';
+import '../stack.cjs';
 import 'node:async_hooks';
-import '../index-BqCiHao8.cjs';
-import '../registry-BWttGlaT.cjs';
+import '../index-Bmvx1EvJ.cjs';
+import '../db/env.cjs';
+import '../registry-C3H2uPeZ.cjs';
 import 'zod';

package/dist/engine/index.d.ts

@@ -1,7 +1,8 @@
-export { A as App, l as AuthVerifier, B as BootRefused, m as CreateAppOptions, E as EgressPolicy, n as EngineConfig, M as ModuleClients, o as RateLimiter, p as RequestDatabase, q as RouteEntry, r as RuntimeHooks, s as ScrubResult, t as SqlDriver, u as SqlTx, v as buildRouteTable, w as createApp, x as createLazyTransaction, y as createOps, z as createRequestDatabase, G as effectiveAuth, H as hostAllowed, I as installEgressFence, J as loadConfig, K as makeMemoryCache, O as matchRoute, Q as quoteIdent, T as scrubSecrets, U as withTables } from '../index-CCZqzych.js';
-import '../endpoint-BVT6jcVW.js';
-import '../db/env.js';
+export { A as App, h as AuthVerifier, B as BootRefused, i as CreateAppOptions, E as EgressPolicy, j as EngineConfig, M as ModuleClients, k as RateLimiter, l as RequestDatabase, m as RouteEntry, n as RuntimeHooks, o as ScrubResult, p as SqlDriver, q as SqlTx, r as buildRouteTable, s as createApp, t as createLazyTransaction, u as createOps, v as createRequestDatabase, w as effectiveAuth, x as hostAllowed, y as installEgressFence, z as loadConfig, G as makeMemoryCache, H as matchRoute, I as quoteIdent, J as scrubSecrets, K as withTables } from '../index-B7YBEG5w.js';
+import '../endpoint-BavvbW4P.js';
+import '../stack.js';
 import 'node:async_hooks';
-import '../index-vwHoS0l2.js';
-import '../registry-Bsuf-orT.js';
+import '../index-B3jmmItD.js';
+import '../db/env.js';
+import '../registry-DY3d9l1k.js';
 import 'zod';

package/dist/engine/index.js

@@ -16,10 +16,10 @@ import {
   quoteIdent,
   scrubSecrets,
   withTables
-} from "../chunk-74XDEF5J.js";
-import "../chunk-SQC5EIWY.js";
+} from "../chunk-REZU6UKT.js";
+import "../chunk-FSGSB42K.js";
 import "../chunk-W5ODXPY3.js";
-import "../chunk-QMVK4X3V.js";
+import "../chunk-OMRTHM4X.js";
 import "../chunk-7D4SUZUM.js";
 export {
   AuthVerifier,

package/dist/{index-vwHoS0l2.d.ts → index-B3jmmItD.d.ts}

@@ -1,5 +1,5 @@
 import { Tables, TableTypes } from './db/env.js';
-import { D as DBClient, b8 as TxPlanHandle, bh as TxTable, M as Materialized } from './endpoint-BVT6jcVW.js';
+import { D as DBClient, b8 as TxPlanHandle, bh as TxTable, M as Materialized } from './endpoint-BavvbW4P.js';
 
 /** On delete action for foreign key references. */
 type OnDeleteAction = 'cascade' | 'set null' | 'restrict' | 'no action';
@@ -347,12 +347,20 @@ interface EmbeddingModelRef {
     apiKeyName?: string;
     baseURL?: string;
 }
+/** Chat/damıtma modeli DESKRIPTORU (C-11, D-019) — memory beyanının extract'i.
+ * Embedding gibi düz veridir; çağrıyı worker yapar, anahtar vault'taki
+ * OPENAI_API_KEY'dir (D-017: aynı sağlayıcı, yeni dış sistem yok). */
+interface ChatModelRef {
+    provider: "openai";
+    model: string;
+}
 declare const openai: {
     embedding(model: string, opts?: {
         dimensions?: number;
         apiKeyName?: string;
         baseURL?: string;
     }): EmbeddingModelRef;
+    chat(model: string): ChatModelRef;
 };
 
 /**
@@ -400,12 +408,44 @@ interface VectorSearchDecl {
      *   eşleşme riski (Confluence-tipi sync yükleri için). */
     staleness?: "null" | "keep";
 }
-/** Tablonun arama beyanı. `text`: FTS kolonları (sabit 'simple' sözlük, D-4 — palbase_fts + GIN türetilir).
- * `vector`: bir ya da birden çok ANN kolu. İkisi de opsiyonel; blok yoksa tablo yine
- * vector kolonu varlığıyla aranabilir (D-3/FR-013). */
+/** Tablonun arama beyanı — İKİ biçim (D-007, tek yüzey):
+ *
+ * YENİ (önerilen): `{ from, model, ... }` — `from` kolonları hem FTS'e hem
+ * embed'e girer. Tabloda vector kolonu declare edilmişse SATIR-modu; yoksa
+ * CHUNK-modu otomatiktir (D-010): vektörler türev `__palbase_chunks`
+ * tablosunda yaşar, içerik otomatik bölünür. `text: false` FTS'i kapatır,
+ * `text: [..]` FTS kolonlarını from'dan ayırır. `chunks` yalnız ince ayar.
+ *
+ * ESKİ: `text: string[]` + `vector: {...}` — aynen çalışır, wire çıktısı
+ * bayt-aynı kalır (NFR-B1). İki biçim KARIŞTIRILAMAZ. */
 interface SearchDecl {
-    text?: string[];
+    text?: string[] | boolean;
     vector?: VectorSearchDecl | VectorSearchDecl[];
+    /** Yeni biçim: arama kaynağı kolonlar (FTS + embed). Varlığı yeni biçimi seçer. */
+    from?: string[];
+    /** Yeni biçim: auto-embed modeli (zorunlu — BYO için eski biçimi kullanın). */
+    model?: EmbeddingModelRef;
+    metric?: SearchMetric;
+    staleness?: "null" | "keep";
+    /** Chunk-modu ince ayarı (yalnız vector kolonsuz tabloda anlamlı). */
+    chunks?: {
+        size?: number;
+        overlap?: number;
+    };
+    /** Sorgu-yeniden-yazımı: tek yönlü eş anlamlı haritası (FR-026). */
+    synonyms?: Record<string, string[]>;
+    /** Geçerlilik kolonları türetilir; arama varsayılan yalnız günceli tarar (FR-029). */
+    validity?: boolean;
+}
+/** Hafıza beyanı (FR-032, D-019): kaynak tablonun yazımlarından platform
+ * fact damıtır ve `into` tablosuna yazar. Hedef NORMAL declared tablodur —
+ * kendi search/unique/validity beyanlarıyla. Okuma = Database.search(into).
+ * subject default "owner": fact'in kime ait olduğu kolonu (iki tabloda da). */
+interface MemoryDecl {
+    from: string[];
+    into: string;
+    extract: ChatModelRef;
+    subject?: string;
 }
 interface TableInput<C extends ColumnMap = ColumnMap> {
     columns: C;
@@ -448,6 +488,8 @@ interface TableInput<C extends ColumnMap = ColumnMap> {
     }[];
     /** Arama beyanı — bkz. SearchDecl. */
     search?: SearchDecl;
+    /** Hafıza beyanı — bkz. MemoryDecl (FR-032). */
+    memory?: MemoryDecl;
 }
 /**
  * A table definition — the runtime value the Go runtime's `schema_extract.js`
@@ -485,6 +527,8 @@ interface TableDef<C extends ColumnMap = ColumnMap> {
     }[];
     /** Arama beyanı, doğrulanmış ve taşınmış hali. */
     search?: SearchDecl;
+    /** Hafıza beyanı, doğrulanmış ve taşınmış hali (FR-032). */
+    memory?: MemoryDecl;
 }
 /**
  * A schema definition containing multiple tables, keyed by table name.
@@ -662,7 +706,52 @@ interface SearchParamsTyped<T extends TableTypes> {
     /** Birden çok vektör kolonunda hedef seçimi (model geçişi, FR-013/using). */
     using?: string;
     mode?: "hybrid" | "text" | "vector";
+    /** Nihai (RRF-sonrası) skor alt eşiği — süzme LIMIT'ten önce uygulanır (FR-001). */
+    minScore?: number;
+    /** Chunk-modunda satır başına en iyi blok sayısı (1..10, vars. 3; FR-015). */
+    blocksPerRow?: number;
+    /** Tazelik çürümesi: nihai skor RRF-sonrası exp(-ln(2)*yaş/halfLife) ile çarpılır;
+     * field bir timestamp kolonu, halfLife "90s" | "15m" | "12h" | "30d" biçiminde (FR-004). */
+    recency?: {
+        field: Extract<keyof T["row"], string>;
+        halfLife: string;
+    };
+    /** Filtrelenmiş küme üzerinde kolon başına top-20 değer sayacı — dönüş
+     * dizisinin `_facets` özelliği (FR-027). */
+    facets?: Extract<keyof T["row"], string>[];
+    /** Satır-modunda FTS eşleşme vurgusu: sonuç satırına `_highlight` ekler;
+     * chunk-modda no-op — bloklar zaten eşleşen kesittir (FR-025). */
+    highlight?: boolean;
+    /** Validity'li tabloda zaman penceresi: varsayılan yalnız güncel versiyon;
+     * "all" tüm versiyonlar; {asOf} o anda geçerli olan (FR-029). */
+    validity?: "all" | {
+        asOf: string;
+    };
+    /** Alan-boost (FR-030): skor * (1 + w·x/(1+x)) — sayısal kolonla sınırlı
+     * çarpan, dış servissiz; bileşim RRF → boost → recency → minScore. */
+    boost?: {
+        field: Extract<keyof T["row"], string>;
+        weight: number;
+    };
 }
+/** search() dönüş dizisinin sorgu-düzeyi ekleri (FR-027): `_facets` dizinin
+ * ÖZELLİĞİDİR, satırlara kopyalanmaz (JSON'a satır başına şişme olmasın). */
+type SearchFacets = Record<string, {
+    value: string | null;
+    count: number;
+}[]>;
+/** similar()/recommend() taşıyıcı opsiyonları (T018, FR-022): search'ün
+ * paramlarından query/vector/mode düşer — hedef vektörü metodun kendisi
+ * DB'den kurar; facets/highlight de düşer (T020) — engine bu ikisini
+ * similar/recommend'e geçirmez, tip vaadi gerçekle aynı kalır. */
+type SimilarParamsTyped<T extends TableTypes> = Omit<SearchParamsTyped<T>, "query" | "vector" | "mode" | "facets" | "highlight">;
+/** recommend() parametreleri (T018, FR-023). */
+type RecommendParamsTyped<T extends TableTypes> = SimilarParamsTyped<T> & {
+    /** Kaynak beğeniler — hedef vektör bunların DB-içi avg'ı; boş olamaz. */
+    positive: string[];
+    /** İtilen örnekler — hedef pos.v + (pos.v - neg.v) ile yönlenir. */
+    negative?: string[];
+};
 /** Temel tablo erişimcisi — search'süz beş op. */
 interface EnvTypedTableBase<T extends TableTypes> {
     insert(data: T["insert"]): Promise<T["row"]>;
@@ -673,6 +762,11 @@ interface EnvTypedTableBase<T extends TableTypes> {
     delete(id: string): Promise<void>;
     findById(id: string): Promise<T["row"] | null>;
     findMany(query?: Partial<T["row"]>): Promise<T["row"][]>;
+    /** Validity'li tabloda satırın yeni versiyonu (FR-029, C-9): eski satır
+     * kapanır (valid_to/superseded_by), yenisi TEK savepoint'te eklenir; dönüş
+     * yeni satır. Validity beyanı olmayan tabloda adlandırılmış çalışma-zamanı
+     * hatası — tip düzeyinde ayrım env `Tables` bayrağı taşımadığından yapılamaz. */
+    supersede(id: string, row: T["insert"]): Promise<T["row"]>;
 }
 /** Tablo erişimcisi: env girdisi `searchable: true` taşıyorsa (vector kolonu ya da
  * search beyanı — env-gen üretir) `search()` üyesi VARDIR; yoksa üye hiç yoktur ve
@@ -682,6 +776,18 @@ type EnvTypedTable<T extends TableTypes> = EnvTypedTableBase<T> & (T extends {
 } ? {
     search(params: SearchParamsTyped<T>): Promise<Array<T["row"] & {
         _score: number;
+    }> & {
+        _facets?: SearchFacets;
+    }>;
+    /** "Bu satıra benzeyenler" (FR-022): hedef vektör DB'den okunur,
+     * kaynak satır sonuçta yoktur; id yoksa adlandırılmış hata. */
+    similar(id: string, params?: SimilarParamsTyped<T>): Promise<Array<T["row"] & {
+        _score: number;
+    }>>;
+    /** positive/negative beğenilerden öneri (FR-023): hedef vektör DB-içi
+     * avg CTE'leriyle; kaynak id'ler sonuçta yoktur. */
+    recommend(params: RecommendParamsTyped<T>): Promise<Array<T["row"] & {
+        _score: number;
     }>>;
 } : Record<never, never>);
 /** The `tables` map exposed on `Database`/`tx`, keyed by the env `Tables`

package/dist/{index-CCZqzych.d.ts → index-B7YBEG5w.d.ts}

@@ -1,63 +1,8 @@
-import { Buckets, BucketTypes } from './db/env.js';
+import { Buckets, BucketTypes } from './stack.js';
 import { AsyncLocalStorage } from 'node:async_hooks';
-import { C as CacheClient, P as PalbaseDocsClient, a as PalbaseFlagsClient, L as Logger, b as PalbaseNotificationsClient, c as PalbaseRealtimeClient, D as DBClient, S as SecretsService, d as PalbaseStorageClient, e as PalbaseBucketClient, T as TxPlanBody, f as TxPlanResponse } from './endpoint-BVT6jcVW.js';
-import { E as EnvTypedDatabase } from './index-vwHoS0l2.js';
-import { R as RouteMeta } from './registry-Bsuf-orT.js';
-
-/**
- * The purchases surface the decorators need, declared as a NARROW STRUCTURAL
- * interface rather than an import of `@palstore/purchases`.
- *
- * `PurchasesClient` (palstore's `sk_` backend SDK) satisfies this shape as-is,
- * so the runtime injects the real client with no adapter — but `@palbase/backend`
- * itself gains no dependency on it. That matters: this package is published
- * public and baked into the br-pod image from a tarball, so a dependency on an
- * unpublished sibling would break `npm install palbase-backend.tgz`. It is also
- * the pattern `withSpend` already uses for the same reason (`SpendCapableClient`
- * in palstore's own spend.ts: "a narrow structural interface … so this file has
- * no dependency on client.ts").
- *
- * The methods here are a SUBSET of `PurchasesClient` — only what the two
- * decorators call. Grants, refunds, credits and customer-info reads stay off
- * this interface: a tenant that wants them imports the palstore SDK directly.
- */
-/** Store environment a subject is fixed to. Mirrors `StoreEnv` in `@palstore/purchases`. */
-type StoreEnv = "production" | "sandbox";
-/** Quota/credit state carried by a 429. Mirrors `LimitState` in `@palstore/purchases`
- * (SPEC-purchases-v1 §11) — re-declared, not imported, for the reason above. */
-interface LimitState {
-    key: string;
-    scope: string;
-    window: string;
-    used: number;
-    reserved: number;
-    max: number;
-    remaining: number;
-    resetAt: string;
-}
-/** Options for one spend. `idempotencyKey` is required by the server (§9). */
-interface SpendOptions {
-    /** Defaults to 1. */
-    count?: number;
-    idempotencyKey: string;
-}
-interface PurchasesService {
-    /** Map a tenant-side user reference to its palstore subject, creating one on
-     * first sight. Server-authoritative — the caller never names a subject. */
-    resolveSubject(input: {
-        userRef: string;
-        storeEnv: StoreEnv;
-    }): Promise<{
-        subjectId: string;
-    }>;
-    /** Resolve silently when `entitlementKey` is active for `subjectId`; throw
-     * `EntitlementRequiredError` otherwise. Consumes nothing. */
-    require(subjectId: string, entitlementKey: string): Promise<void>;
-    /** Reserve → run `handler` → commit on success, cancel on throw, always
-     * rethrowing the handler's own error. The whole reason the decorators are a
-     * thin layer: this lifecycle is already written and tested in palstore's SDK. */
-    withSpend<T>(subjectId: string, key: string, opts: SpendOptions, handler: () => Promise<T>): Promise<T>;
-}
+import { C as CacheClient, P as PalbaseDocsClient, a as PalbaseFlagsClient, L as Logger, b as PalbaseNotificationsClient, c as PalbaseRealtimeClient, D as DBClient, S as SecretsService, d as PalbaseStorageClient, e as PalbaseBucketClient, T as TxPlanBody, f as TxPlanResponse } from './endpoint-BavvbW4P.js';
+import { E as EnvTypedDatabase } from './index-B3jmmItD.js';
+import { R as RouteMeta } from './registry-DY3d9l1k.js';
 
 /**
  * runtime.ts — request-scoped service singletons.
@@ -118,7 +63,6 @@ interface RuntimeServices {
     Notifications: PalbaseNotificationsClient;
     Flags: PalbaseFlagsClient;
     Realtime: PalbaseRealtimeClient;
-    Purchases: PurchasesService;
 }
 /**
  * The per-request ALS box.
@@ -239,15 +183,6 @@ declare const Secrets: SecretsService;
 declare const Log: Logger;
 /** Push / email / SMS / in-app notifications. */
 declare const Notifications: PalbaseNotificationsClient;
-/**
- * Palstore purchases (entitlements + quota/credit spend).
- *
- * Reached by handlers through the `@RequireEntitlement` / `@Spend` decorators
- * rather than called directly in the common case; exposed as a singleton for
- * the cases the decorators deliberately do not cover (a dynamic spend count,
- * which must run BEFORE the billable side-effect).
- */
-declare const Purchases: PurchasesService;
 /**
  * Feature flags.
  *
@@ -448,7 +383,97 @@ declare function createOps(tx: TxLike): {
         limit?: number;
         using?: string;
         mode?: "hybrid" | "text" | "vector";
+        /** Nihai (RRF-sonrası) skor alt eşiği — süzme LIMIT'ten ÖNCE (FR-001). */
+        minScore?: number;
+        /** RRF-sonrası üstel tazelik çürümesi: _score * exp(-ln(2)*yaş/halfLife) (FR-004). */
+        recency?: {
+            field: string;
+            halfLife: string;
+        };
+        /** Chunk-modunda satır başına dönen en iyi blok sayısı (1..10, vars. 3; FR-015). */
+        blocksPerRow?: number;
+        /** Filtrelenmiş küme üzerinde kolon başına top-20 değer sayacı —
+         * dönüş dizisinin `_facets` özelliği (FR-027). */
+        facets?: string[];
+        /** Satır-modunda FTS eşleşme vurgusu: ts_headline ile `_highlight`
+         * alanı; chunk-modda no-op — bloklar zaten eşleşen kesittir (FR-025). */
+        highlight?: boolean;
+        /** Validity'li tabloda zaman penceresi: varsayılan yalnız güncel;
+         * "all" tüm versiyonlar; {asOf} o andaki geçerli versiyon (FR-029). */
+        validity?: "all" | {
+            asOf: string;
+        };
+        /** Alan-boost (FR-030): skor * (1 + w·x/(1+x)) — sınırlı, dış servissiz. */
+        boost?: {
+            field: string;
+            weight: number;
+        };
     }): Promise<Row[]>;
+    /**
+     * similar (T018, FR-022): "bu satıra benzeyenler". Hedef vektör DB'den
+     * okunur — satır-modu satırın kendi kolonu, chunk-modu parent chunk'larının
+     * şema-nitelikli avg'ı — ve ana arama search'ün vector yoluyla koşar;
+     * kaynak satır sonuçtan düşer. İKİ tur BİLİNÇLİ (plan T018): target-CTE'li
+     * tek SQL'de "id yok" ile "0 komşu" ayrılamazdı; +1 küçük turla id-yokluğu
+     * adlandırılmış hataya çevrilir. Sonuç şekli search ile aynı (FR-015).
+     */
+    similar(table: string, id: string, opts?: {
+        where?: Record<string, unknown>;
+        limit?: number;
+        using?: string;
+        minScore?: number;
+        recency?: {
+            field: string;
+            halfLife: string;
+        };
+        blocksPerRow?: number;
+        validity?: "all" | {
+            asOf: string;
+        };
+        boost?: {
+            field: string;
+            weight: number;
+        };
+    }): Promise<Row[]>;
+    /**
+     * recommend (T018, FR-023): positive/negative id kümelerinden öneri.
+     * Hedef vektör DB-İÇİ CTE'lerle türer: pos = avg(embedding of positives),
+     * negative varsa hedef = pos.v + (pos.v - neg.v) — pgvector avg agregası
+     * ve +/- operatörleri ŞEMA-NİTELİKLİ (M-1: search_path'e güvenilmez).
+     * Vektör matematiği istemciye inmez; bulunamayan positive/negative
+     * adlandırılmış hatadır ve kaynak id'ler sonuçtan düşer.
+     */
+    recommend(table: string, opts: {
+        positive: unknown[];
+        negative?: unknown[];
+        where?: Record<string, unknown>;
+        limit?: number;
+        using?: string;
+        minScore?: number;
+        recency?: {
+            field: string;
+            halfLife: string;
+        };
+        blocksPerRow?: number;
+        validity?: "all" | {
+            asOf: string;
+        };
+        boost?: {
+            field: string;
+            weight: number;
+        };
+    }): Promise<Row[]>;
+    /**
+     * supersede (T021, FR-029, C-9): validity'li tabloda satırın YENİ
+     * versiyonunu TEK savepoint'te yazar — eski satır kapatılır
+     * (valid_to = now(), superseded_by = yeni pk), yeni satır eklenir, dönüş
+     * yeni satırdır. Yeni pk CLIENT'ta üretilir (row'da verilmemişse
+     * randomUUID — declared şemaların uuid().defaultRandom() standardı) ki
+     * kapatma UPDATE'i INSERT'ten ÖNCE koşabilsin: 0 satır = zaten superseded
+     * ya da yok → INSERT hiç denenmez; INSERT hatası ise savepoint'le
+     * kapatmayı da geri sarar — yarım supersede diye bir durum yoktur.
+     */
+    supersede(table: string, id: string, row: Row): Promise<Row>;
     /** A real SAVEPOINT inside the request's transaction. */
     transaction<T>(cb: (t: unknown) => Promise<T>): Promise<T>;
     /**
@@ -800,7 +825,7 @@ interface RuntimeHooks {
     __requestALS: typeof __requestALS;
 }
 /** The module singletons the engine injects, minus the two it owns itself. */
-type ModuleClients = Partial<Pick<RuntimeServices, "Documents" | "Storage" | "Notifications" | "Flags" | "Realtime" | "Purchases" | "Secrets">>;
+type ModuleClients = Partial<Pick<RuntimeServices, "Documents" | "Storage" | "Notifications" | "Flags" | "Realtime" | "Secrets">>;
 interface CreateAppOptions {
     /**
      * Vault'tan TEK secret okuma (FR-025): sorgu-anı embedding'in anahtarı
@@ -854,4 +879,4 @@ interface App {
  */
 declare function createApp(opts: CreateAppOptions): Promise<App>;
 
-export { type App as A, BootRefused as B, Cache as C, Database as D, type EgressPolicy as E, Flags as F, effectiveAuth as G, hostAllowed as H, installEgressFence as I, loadConfig as J, makeMemoryCache as K, type LimitState as L, type ModuleClients as M, Notifications as N, matchRoute as O, Purchases as P, quoteIdent as Q, Realtime as R, Secrets as S, scrubSecrets as T, withTables as U, __getRuntime as _, Documents as a, Log as b, type PurchasesService as c, type RequestStore as d, type RuntimeServices as e, type SpendOptions as f, Storage as g, type StoreEnv as h, __requestALS as i, __runWithRuntime as j, __setRuntime as k, AuthVerifier as l, type CreateAppOptions as m, type EngineConfig as n, RateLimiter as o, type RequestDatabase as p, type RouteEntry as q, type RuntimeHooks as r, type ScrubResult as s, type SqlDriver as t, type SqlTx as u, buildRouteTable as v, createApp as w, createLazyTransaction as x, createOps as y, createRequestDatabase as z };
+export { type App as A, BootRefused as B, Cache as C, Database as D, type EgressPolicy as E, Flags as F, makeMemoryCache as G, matchRoute as H, quoteIdent as I, scrubSecrets as J, withTables as K, Log as L, type ModuleClients as M, Notifications as N, Realtime as R, Secrets as S, __getRuntime as _, Documents as a, type RequestStore as b, type RuntimeServices as c, Storage as d, __requestALS as e, __runWithRuntime as f, __setRuntime as g, AuthVerifier as h, type CreateAppOptions as i, type EngineConfig as j, RateLimiter as k, type RequestDatabase as l, type RouteEntry as m, type RuntimeHooks as n, type ScrubResult as o, type SqlDriver as p, type SqlTx as q, buildRouteTable as r, createApp as s, createLazyTransaction as t, createOps as u, createRequestDatabase as v, effectiveAuth as w, hostAllowed as x, installEgressFence as y, loadConfig as z };

package/dist/{index-BqCiHao8.d.cts → index-Bmvx1EvJ.d.cts}

@@ -1,5 +1,5 @@
 import { Tables, TableTypes } from './db/env.cjs';
-import { D as DBClient, b8 as TxPlanHandle, bh as TxTable, M as Materialized } from './endpoint-BVT6jcVW.cjs';
+import { D as DBClient, b8 as TxPlanHandle, bh as TxTable, M as Materialized } from './endpoint-i8TTCohk.cjs';
 
 /** On delete action for foreign key references. */
 type OnDeleteAction = 'cascade' | 'set null' | 'restrict' | 'no action';
@@ -347,12 +347,20 @@ interface EmbeddingModelRef {
     apiKeyName?: string;
     baseURL?: string;
 }
+/** Chat/damıtma modeli DESKRIPTORU (C-11, D-019) — memory beyanının extract'i.
+ * Embedding gibi düz veridir; çağrıyı worker yapar, anahtar vault'taki
+ * OPENAI_API_KEY'dir (D-017: aynı sağlayıcı, yeni dış sistem yok). */
+interface ChatModelRef {
+    provider: "openai";
+    model: string;
+}
 declare const openai: {
     embedding(model: string, opts?: {
         dimensions?: number;
         apiKeyName?: string;
         baseURL?: string;
     }): EmbeddingModelRef;
+    chat(model: string): ChatModelRef;
 };
 
 /**
@@ -400,12 +408,44 @@ interface VectorSearchDecl {
      *   eşleşme riski (Confluence-tipi sync yükleri için). */
     staleness?: "null" | "keep";
 }
-/** Tablonun arama beyanı. `text`: FTS kolonları (sabit 'simple' sözlük, D-4 — palbase_fts + GIN türetilir).
- * `vector`: bir ya da birden çok ANN kolu. İkisi de opsiyonel; blok yoksa tablo yine
- * vector kolonu varlığıyla aranabilir (D-3/FR-013). */
+/** Tablonun arama beyanı — İKİ biçim (D-007, tek yüzey):
+ *
+ * YENİ (önerilen): `{ from, model, ... }` — `from` kolonları hem FTS'e hem
+ * embed'e girer. Tabloda vector kolonu declare edilmişse SATIR-modu; yoksa
+ * CHUNK-modu otomatiktir (D-010): vektörler türev `__palbase_chunks`
+ * tablosunda yaşar, içerik otomatik bölünür. `text: false` FTS'i kapatır,
+ * `text: [..]` FTS kolonlarını from'dan ayırır. `chunks` yalnız ince ayar.
+ *
+ * ESKİ: `text: string[]` + `vector: {...}` — aynen çalışır, wire çıktısı
+ * bayt-aynı kalır (NFR-B1). İki biçim KARIŞTIRILAMAZ. */
 interface SearchDecl {
-    text?: string[];
+    text?: string[] | boolean;
     vector?: VectorSearchDecl | VectorSearchDecl[];
+    /** Yeni biçim: arama kaynağı kolonlar (FTS + embed). Varlığı yeni biçimi seçer. */
+    from?: string[];
+    /** Yeni biçim: auto-embed modeli (zorunlu — BYO için eski biçimi kullanın). */
+    model?: EmbeddingModelRef;
+    metric?: SearchMetric;
+    staleness?: "null" | "keep";
+    /** Chunk-modu ince ayarı (yalnız vector kolonsuz tabloda anlamlı). */
+    chunks?: {
+        size?: number;
+        overlap?: number;
+    };
+    /** Sorgu-yeniden-yazımı: tek yönlü eş anlamlı haritası (FR-026). */
+    synonyms?: Record<string, string[]>;
+    /** Geçerlilik kolonları türetilir; arama varsayılan yalnız günceli tarar (FR-029). */
+    validity?: boolean;
+}
+/** Hafıza beyanı (FR-032, D-019): kaynak tablonun yazımlarından platform
+ * fact damıtır ve `into` tablosuna yazar. Hedef NORMAL declared tablodur —
+ * kendi search/unique/validity beyanlarıyla. Okuma = Database.search(into).
+ * subject default "owner": fact'in kime ait olduğu kolonu (iki tabloda da). */
+interface MemoryDecl {
+    from: string[];
+    into: string;
+    extract: ChatModelRef;
+    subject?: string;
 }
 interface TableInput<C extends ColumnMap = ColumnMap> {
     columns: C;
@@ -448,6 +488,8 @@ interface TableInput<C extends ColumnMap = ColumnMap> {
     }[];
     /** Arama beyanı — bkz. SearchDecl. */
     search?: SearchDecl;
+    /** Hafıza beyanı — bkz. MemoryDecl (FR-032). */
+    memory?: MemoryDecl;
 }
 /**
  * A table definition — the runtime value the Go runtime's `schema_extract.js`
@@ -485,6 +527,8 @@ interface TableDef<C extends ColumnMap = ColumnMap> {
     }[];
     /** Arama beyanı, doğrulanmış ve taşınmış hali. */
     search?: SearchDecl;
+    /** Hafıza beyanı, doğrulanmış ve taşınmış hali (FR-032). */
+    memory?: MemoryDecl;
 }
 /**
  * A schema definition containing multiple tables, keyed by table name.
@@ -662,7 +706,52 @@ interface SearchParamsTyped<T extends TableTypes> {
     /** Birden çok vektör kolonunda hedef seçimi (model geçişi, FR-013/using). */
     using?: string;
     mode?: "hybrid" | "text" | "vector";
+    /** Nihai (RRF-sonrası) skor alt eşiği — süzme LIMIT'ten önce uygulanır (FR-001). */
+    minScore?: number;
+    /** Chunk-modunda satır başına en iyi blok sayısı (1..10, vars. 3; FR-015). */
+    blocksPerRow?: number;
+    /** Tazelik çürümesi: nihai skor RRF-sonrası exp(-ln(2)*yaş/halfLife) ile çarpılır;
+     * field bir timestamp kolonu, halfLife "90s" | "15m" | "12h" | "30d" biçiminde (FR-004). */
+    recency?: {
+        field: Extract<keyof T["row"], string>;
+        halfLife: string;
+    };
+    /** Filtrelenmiş küme üzerinde kolon başına top-20 değer sayacı — dönüş
+     * dizisinin `_facets` özelliği (FR-027). */
+    facets?: Extract<keyof T["row"], string>[];
+    /** Satır-modunda FTS eşleşme vurgusu: sonuç satırına `_highlight` ekler;
+     * chunk-modda no-op — bloklar zaten eşleşen kesittir (FR-025). */
+    highlight?: boolean;
+    /** Validity'li tabloda zaman penceresi: varsayılan yalnız güncel versiyon;
+     * "all" tüm versiyonlar; {asOf} o anda geçerli olan (FR-029). */
+    validity?: "all" | {
+        asOf: string;
+    };
+    /** Alan-boost (FR-030): skor * (1 + w·x/(1+x)) — sayısal kolonla sınırlı
+     * çarpan, dış servissiz; bileşim RRF → boost → recency → minScore. */
+    boost?: {
+        field: Extract<keyof T["row"], string>;
+        weight: number;
+    };
 }
+/** search() dönüş dizisinin sorgu-düzeyi ekleri (FR-027): `_facets` dizinin
+ * ÖZELLİĞİDİR, satırlara kopyalanmaz (JSON'a satır başına şişme olmasın). */
+type SearchFacets = Record<string, {
+    value: string | null;
+    count: number;
+}[]>;
+/** similar()/recommend() taşıyıcı opsiyonları (T018, FR-022): search'ün
+ * paramlarından query/vector/mode düşer — hedef vektörü metodun kendisi
+ * DB'den kurar; facets/highlight de düşer (T020) — engine bu ikisini
+ * similar/recommend'e geçirmez, tip vaadi gerçekle aynı kalır. */
+type SimilarParamsTyped<T extends TableTypes> = Omit<SearchParamsTyped<T>, "query" | "vector" | "mode" | "facets" | "highlight">;
+/** recommend() parametreleri (T018, FR-023). */
+type RecommendParamsTyped<T extends TableTypes> = SimilarParamsTyped<T> & {
+    /** Kaynak beğeniler — hedef vektör bunların DB-içi avg'ı; boş olamaz. */
+    positive: string[];
+    /** İtilen örnekler — hedef pos.v + (pos.v - neg.v) ile yönlenir. */
+    negative?: string[];
+};
 /** Temel tablo erişimcisi — search'süz beş op. */
 interface EnvTypedTableBase<T extends TableTypes> {
     insert(data: T["insert"]): Promise<T["row"]>;
@@ -673,6 +762,11 @@ interface EnvTypedTableBase<T extends TableTypes> {
     delete(id: string): Promise<void>;
     findById(id: string): Promise<T["row"] | null>;
     findMany(query?: Partial<T["row"]>): Promise<T["row"][]>;
+    /** Validity'li tabloda satırın yeni versiyonu (FR-029, C-9): eski satır
+     * kapanır (valid_to/superseded_by), yenisi TEK savepoint'te eklenir; dönüş
+     * yeni satır. Validity beyanı olmayan tabloda adlandırılmış çalışma-zamanı
+     * hatası — tip düzeyinde ayrım env `Tables` bayrağı taşımadığından yapılamaz. */
+    supersede(id: string, row: T["insert"]): Promise<T["row"]>;
 }
 /** Tablo erişimcisi: env girdisi `searchable: true` taşıyorsa (vector kolonu ya da
  * search beyanı — env-gen üretir) `search()` üyesi VARDIR; yoksa üye hiç yoktur ve
@@ -682,6 +776,18 @@ type EnvTypedTable<T extends TableTypes> = EnvTypedTableBase<T> & (T extends {
 } ? {
     search(params: SearchParamsTyped<T>): Promise<Array<T["row"] & {
         _score: number;
+    }> & {
+        _facets?: SearchFacets;
+    }>;
+    /** "Bu satıra benzeyenler" (FR-022): hedef vektör DB'den okunur,
+     * kaynak satır sonuçta yoktur; id yoksa adlandırılmış hata. */
+    similar(id: string, params?: SimilarParamsTyped<T>): Promise<Array<T["row"] & {
+        _score: number;
+    }>>;
+    /** positive/negative beğenilerden öneri (FR-023): hedef vektör DB-içi
+     * avg CTE'leriyle; kaynak id'ler sonuçta yoktur. */
+    recommend(params: RecommendParamsTyped<T>): Promise<Array<T["row"] & {
+        _score: number;
     }>>;
 } : Record<never, never>);
 /** The `tables` map exposed on `Database`/`tx`, keyed by the env `Tables`