@devoplus/one-sdk 0.0.0-stage → 0.2.0-next.112

package/dist/components.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,110 @@
+export interface OneUser {
+    /** devoplus-auth `sub` — UserAccount kimlik uzayı (org şeması User._id DEĞİL). */
+    sub: string;
+    /** Uygulamaya verilmiş scope'lar (manifest'in alt kümesi). */
+    scope: readonly string[];
+    globalAdmin: boolean;
+    /**
+     * Kullanıcının BU uygulamanın ad alanındaki izinleri (`One.<Uygulama>.*`, D-49) — portal yöneticisi Yetki
+     * Yönetimi'nde kullanıcı gruplarına (org düğümlerine) atar. Başka uygulamaların ve portalın izinleri iletilmez.
+     */
+    permissions: readonly string[];
+    /** Portal yöneticisi (şirket ya da küresel yönetici rolü): platformda her izne sahiptir, `hasPermission` de öyle sayar. */
+    admin: boolean;
+}
+/** Oturum bir başkası adına mı kullanılıyor (D-76 U3)? `delegation` = Vekalet, `impersonation` = Yerine Görüntüle. */
+export type OneActingKind = 'delegation' | 'impersonation';
+/**
+ * Vekalet / Yerine Görüntüle oturumunda işlemi GERÇEKTE yapan kişi. `user.sub` adına çalışılan kişidir (veri onundur);
+ * `actor.sub` oturumu kullanan kişidir — denetim kaydına ve "kim yaptı" bilgisine bu yazılır. Varsayılan olarak bu
+ * oturumlar salt-okunurdur: platform GET/HEAD dışındaki isteği uygulamaya ulaşmadan reddeder (manifest
+ * `actingSessions: "write"` beyan edilmedikçe).
+ */
+export interface OneActor {
+    sub: string;
+    kind: OneActingKind;
+}
+export interface OneContext {
+    app: string;
+    portalKey: string;
+    /** Kiracı: 24-hex PortalId. Veri her zaman buna bağlıdır (D-10). */
+    portalId: string;
+    /** Oturum yoksa null — yalnız okuma metotları buraya anonim ulaşabilir. */
+    user: OneUser | null;
+    /**
+     * Vekalet / Yerine Görüntüle oturumunda işlemi yapan kişi (D-76 U3); kendi oturumunda ve anonimde null. `readContext`
+     * her zaman yazar; isteğe bağlı olması yalnız elle kurulan bağlamlar (testler) kırılmasın diyedir.
+     */
+    actor?: OneActor | null;
+    /**
+     * İsteğin geldiği yol (C6). `user`: tarayıcıdan, kullanıcının oturumuyla. `job`: platformun kuyruk ya da zamanlama
+     * çağrısı — Devoplus servisleri UYGULAMANIN kimliğiyle çağrılır (yalnız `jobs.services` beyanı + kurulumdaki yönetici
+     * onayı). `agent`: Devoplus ajanının araç çağrısı — servisler kişi adına çağrılır, süreli onay gerektirenler hariç.
+     * `readContext` her zaman yazar; isteğe bağlı olması yalnız elle kurulan bağlamlar kırılmasın diyedir (yoksa `user`).
+     */
+    mode?: OneRequestMode;
+    /**
+     * Portal yöneticisi mi (`user.admin` ile aynı; oturumsuz ve iş çağrısında `false`). Ajan aracında yalnız çağıran kişi
+     * kurulumun portalının şirket yöneticisiyse `true` olur. `readContext` her zaman yazar.
+     */
+    admin?: boolean;
+    /** İş çağrısında (`mode: 'job'`) manifest `jobs.services` beyanı; diğer yollarda boş. `readContext` her zaman yazar. */
+    jobServices?: readonly string[];
+}
+/** İsteğin geldiği yol — bkz. `OneContext.mode`. */
+export type OneRequestMode = 'user' | 'job' | 'agent';
+export declare class OneError extends Error {
+    readonly status: number;
+    readonly code: string;
+    /**
+     * Sunucunun "bu kadar saniye sonra yeniden deneyin" ipucu (`Retry-After` başlığı ya da ProblemDetails
+     * `retryAfterSeconds` alanı); yoksa `undefined`. Örnek: DEXA komutu 409 `ERPCMD-APP-E-016` (aynı işlem sürüyor).
+     */
+    readonly retryAfterSeconds: number | undefined;
+    constructor(status: number, code: string, detail: string, options?: {
+        retryAfterSeconds?: number | undefined;
+    });
+}
+export declare function readContext(headers: Headers): OneContext;
+/** Oturum bir başkası adına mı (Vekalet ya da Yerine Görüntüle)? */
+export declare function isActingSession(ctx: OneContext): boolean;
+/** Oturum zorunlu uçlar için: anonimse 401 fırlatır. */
+export declare function requireUser(ctx: OneContext): OneUser;
+/**
+ * Kullanıcının AYRICA ve SÜRELİ onay vermesi gereken scope'lar (karar defteri D-59): ERP'ye veri yazma ve kullanıcı
+ * adına e-posta/SMS/mobil bildirim. Manifest'te beyan edilmiş ve kullanıcının yetkisi olsa bile, kullanıcı bu uygulamaya
+ * bu portalda onay vermeden (30 gün geçerli) belirtece GİRMEZ; portal uygulamanın üstünde bir uyarı ve "İzinleri incele"
+ * düğmesi gösterir. Liste devoplus-auth `ONE_APP_CONSENT.scopes` ile aynıdır. `dexa.read` bu listede DEĞİLDİR.
+ */
+export declare const CONSENT_SCOPES: readonly string[];
+/**
+ * Bu scope kullanıcının ayrı onayına bağlı ve belirteçte YOK mu? Uygulama ilgili düğmeyi kapatıp "portaldaki İzinleri
+ * incele düğmesiyle izin verin" diyebilsin diye. ⚠️ Belirteç yalnız scope'un OLMADIĞINI söyler: manifest'te hiç
+ * beyan edilmemiş bir scope için de `true` döner — beyan uygulamanın kendi bilgisidir. Oturumsuzsa `false`.
+ */
+export declare function awaitsUserConsent(ctx: OneContext, scope: string): boolean;
+/**
+ * Scope kapısı: uygulama manifest'te beyan etmediği bir işi yapamaz. Onaya bağlı scope'ta (`CONSENT_SCOPES`) hata metni
+ * kullanıcıya izni nereden vereceğini de söyler; kod aynı kalır (`ONE-SDK-E-003`).
+ */
+export declare function requireScope(ctx: OneContext, scope: string): OneUser;
+/**
+ * Devoplus servis çağrısının yerel scope kapısı (C6) — servis istemcileri bunu kullanır; asıl karar backend'dedir.
+ *   - `user`: `requireScope` ile aynı (kullanıcının belirtecindeki scope).
+ *   - `agent`: kişi adına; süreli onay gerektiren scope'lar (`CONSENT_SCOPES` — e-posta, SMS, bildirim, DEXA'ya yazma)
+ *     ajan aracında HİÇ kullanılamaz (kişi bu çağrıda onay ekranını göremez).
+ *   - `job`: kullanıcı GEREKMEZ; scope manifest `jobs.services` beyanında olmalı. Beyan yetmez: servis ancak kurulumda
+ *     portal yöneticisi onaylarsa açılır (onay backend'de denetlenir, uygulama göremez → onaysızsa backend 403 döner).
+ */
+export declare function requireServiceScope(ctx: OneContext, scope: string): void;
+/**
+ * Uygulama izni (D-49): kullanıcıda kod varsa ya da portal yöneticisiyse `true` (backend'in yönetici baypasıyla aynı
+ * kural — yönetici için HER kodda `true`). Anonim bağlamda `false`. Kod uygulamanın kendi ad alanında olmalıdır
+ * (`One.<Uygulama>.<Eylem>`); başka ad alanındaki kod dispatch'ten hiç gelmediği için yönetici olmayan kullanıcıda
+ * `false` döner. ⚠️ Ad alanı süzgeci bir kolaylıktır, gizlilik sınırı DEĞİL: belirteç kullanıcının bütün izinlerini
+ * taşır (inceleme bulgusu P2-1).
+ */
+export declare function hasPermission(ctx: OneContext, code: string): boolean;
+/** İzin kapısı: oturum yoksa 401, izin yoksa 403 (`ONE-SDK-E-004`). */
+export declare function requirePermission(ctx: OneContext, code: string): OneUser;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAA;IACX,8DAA8D;IAC9D,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,WAAW,EAAE,OAAO,CAAA;IACpB;;;OAGG;IACH,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,2HAA2H;IAC3H,KAAK,EAAE,OAAO,CAAA;CACf;AAED,sHAAsH;AACtH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,eAAe,CAAA;AAE1D;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,aAAa,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IACvB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,wHAAwH;IACxH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAChC;AAED,oDAAoD;AACpD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAA;AAErD,qBAAa,QAAS,SAAQ,KAAK;IAQ/B,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IARvB;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAA;IAE9C,YACW,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAO,EAIzD;CACF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAmCxD;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAExD;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAGpD;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAAkE,CAAA;AAE9G;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAWpE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAexE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAIpE;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAIxE"}

package/dist/context.js

@@ -0,0 +1,126 @@
+export class OneError extends Error {
+    status;
+    code;
+    /**
+     * Sunucunun "bu kadar saniye sonra yeniden deneyin" ipucu (`Retry-After` başlığı ya da ProblemDetails
+     * `retryAfterSeconds` alanı); yoksa `undefined`. Örnek: DEXA komutu 409 `ERPCMD-APP-E-016` (aynı işlem sürüyor).
+     */
+    retryAfterSeconds;
+    constructor(status, code, detail, options = {}) {
+        super(detail);
+        this.status = status;
+        this.code = code;
+        this.retryAfterSeconds = options.retryAfterSeconds;
+    }
+}
+export function readContext(headers) {
+    const app = headers.get('x-one-app');
+    const portalKey = headers.get('x-one-portal-key');
+    const portalId = headers.get('x-one-portal');
+    if (!app || !portalKey || !portalId)
+        // Dispatch dışından çağrı (ör. yanlış route) — bağlamsız çalışmak kiracı sınırını kaybettirir.
+        throw new OneError(500, 'ONE-SDK-E-001', 'Platform bağlamı eksik: istek dispatch üzerinden gelmedi.');
+    const auth = headers.get('x-one-auth');
+    const sub = headers.get('x-one-sub');
+    // `job`: platformun kuyruk işi çağrısı (D-80) — iletiyi bırakan kullanıcının `sub` ve yetki alanlarıyla; izin ve
+    // yönetici bilgisi taşınmaz (boş gelir). Zamanlanmış iş `sub` taşımaz → `user` null.
+    const user = (auth === 'user' || auth === 'job') && sub
+        ? {
+            sub,
+            scope: (headers.get('x-one-scope') ?? '').split(' ').filter(Boolean),
+            globalAdmin: headers.get('x-one-global-admin') === 'true',
+            permissions: (headers.get('x-one-permissions') ?? '').split(' ').filter(Boolean),
+            admin: headers.get('x-one-admin') === 'true',
+        }
+        : null;
+    const actorSub = headers.get('x-one-actor-sub');
+    const sessionKind = headers.get('x-one-session-kind');
+    // Platform iki başlığı birlikte yazar; yalnız biri gelirse (beklenmeyen durum) yine başkası adına sayılır — "kendi
+    // oturumu" varsayımı yazma kararlarını gevşetirdi.
+    const actor = user && (actorSub || sessionKind)
+        ? { sub: actorSub ?? '', kind: sessionKind === 'delegation' ? 'delegation' : 'impersonation' }
+        : null;
+    // Yol: platformun iş çağrısı `X-One-Auth: job`, Devoplus ajanının imzalı çağrısı `X-One-Invoked-By: devoplus-agent`
+    // yazar; istemcinin yazdığı aynı adlı başlıklar platform kapısında silinir.
+    const mode = auth === 'job' ? 'job' : headers.get('x-one-invoked-by') === 'devoplus-agent' ? 'agent' : 'user';
+    const jobServices = mode === 'job' ? (headers.get('x-one-job-services') ?? '').split(' ').filter(Boolean) : [];
+    return { app, portalKey, portalId, user, actor, mode, admin: user?.admin ?? false, jobServices };
+}
+/** Oturum bir başkası adına mı (Vekalet ya da Yerine Görüntüle)? */
+export function isActingSession(ctx) {
+    return ctx.actor != null;
+}
+/** Oturum zorunlu uçlar için: anonimse 401 fırlatır. */
+export function requireUser(ctx) {
+    if (!ctx.user)
+        throw new OneError(401, 'ONE-SDK-E-002', 'Bu işlem için oturum gerekir.');
+    return ctx.user;
+}
+/**
+ * Kullanıcının AYRICA ve SÜRELİ onay vermesi gereken scope'lar (karar defteri D-59): ERP'ye veri yazma ve kullanıcı
+ * adına e-posta/SMS/mobil bildirim. Manifest'te beyan edilmiş ve kullanıcının yetkisi olsa bile, kullanıcı bu uygulamaya
+ * bu portalda onay vermeden (30 gün geçerli) belirtece GİRMEZ; portal uygulamanın üstünde bir uyarı ve "İzinleri incele"
+ * düğmesi gösterir. Liste devoplus-auth `ONE_APP_CONSENT.scopes` ile aynıdır. `dexa.read` bu listede DEĞİLDİR.
+ */
+export const CONSENT_SCOPES = ['dexa.write', 'mail.execute', 'sms.execute', 'push.execute'];
+/**
+ * Bu scope kullanıcının ayrı onayına bağlı ve belirteçte YOK mu? Uygulama ilgili düğmeyi kapatıp "portaldaki İzinleri
+ * incele düğmesiyle izin verin" diyebilsin diye. ⚠️ Belirteç yalnız scope'un OLMADIĞINI söyler: manifest'te hiç
+ * beyan edilmemiş bir scope için de `true` döner — beyan uygulamanın kendi bilgisidir. Oturumsuzsa `false`.
+ */
+export function awaitsUserConsent(ctx, scope) {
+    return ctx.user !== null && CONSENT_SCOPES.includes(scope) && !ctx.user.scope.includes(scope);
+}
+/**
+ * Scope kapısı: uygulama manifest'te beyan etmediği bir işi yapamaz. Onaya bağlı scope'ta (`CONSENT_SCOPES`) hata metni
+ * kullanıcıya izni nereden vereceğini de söyler; kod aynı kalır (`ONE-SDK-E-003`).
+ */
+export function requireScope(ctx, scope) {
+    const user = requireUser(ctx);
+    if (!user.scope.includes(scope))
+        throw new OneError(403, 'ONE-SDK-E-003', CONSENT_SCOPES.includes(scope)
+            ? `Bu işlem için "${scope}" yetkisi gerekir. Bu işlem için ayrıca izninizi vermeniz gerekiyor: portalda uygulamanın üstündeki "İzinleri incele" düğmesini kullanın.`
+            : `Bu işlem için "${scope}" yetkisi gerekir.`);
+    return user;
+}
+/**
+ * Devoplus servis çağrısının yerel scope kapısı (C6) — servis istemcileri bunu kullanır; asıl karar backend'dedir.
+ *   - `user`: `requireScope` ile aynı (kullanıcının belirtecindeki scope).
+ *   - `agent`: kişi adına; süreli onay gerektiren scope'lar (`CONSENT_SCOPES` — e-posta, SMS, bildirim, DEXA'ya yazma)
+ *     ajan aracında HİÇ kullanılamaz (kişi bu çağrıda onay ekranını göremez).
+ *   - `job`: kullanıcı GEREKMEZ; scope manifest `jobs.services` beyanında olmalı. Beyan yetmez: servis ancak kurulumda
+ *     portal yöneticisi onaylarsa açılır (onay backend'de denetlenir, uygulama göremez → onaysızsa backend 403 döner).
+ */
+export function requireServiceScope(ctx, scope) {
+    if (ctx.mode === 'job') {
+        if (!(ctx.jobServices ?? []).includes(scope))
+            throw new OneError(403, 'ONE-SDK-E-003', `Arka plan işinde "${scope}" servisi kullanılamaz: manifest jobs.services içinde beyan edilmeli ve kurulumda portal yöneticisi onaylamalıdır.`);
+        return;
+    }
+    if (ctx.mode === 'agent' && CONSENT_SCOPES.includes(scope)) {
+        requireUser(ctx);
+        throw new OneError(403, 'ONE-SDK-E-003', `"${scope}" yetkisi Devoplus ajanının araç çağrısında kullanılamaz; bu işlemi uygulamanın ekranından yapın.`);
+    }
+    requireScope(ctx, scope);
+}
+/**
+ * Uygulama izni (D-49): kullanıcıda kod varsa ya da portal yöneticisiyse `true` (backend'in yönetici baypasıyla aynı
+ * kural — yönetici için HER kodda `true`). Anonim bağlamda `false`. Kod uygulamanın kendi ad alanında olmalıdır
+ * (`One.<Uygulama>.<Eylem>`); başka ad alanındaki kod dispatch'ten hiç gelmediği için yönetici olmayan kullanıcıda
+ * `false` döner. ⚠️ Ad alanı süzgeci bir kolaylıktır, gizlilik sınırı DEĞİL: belirteç kullanıcının bütün izinlerini
+ * taşır (inceleme bulgusu P2-1).
+ */
+export function hasPermission(ctx, code) {
+    const user = ctx.user;
+    if (!user)
+        return false;
+    return user.admin || user.permissions.includes(code);
+}
+/** İzin kapısı: oturum yoksa 401, izin yoksa 403 (`ONE-SDK-E-004`). */
+export function requirePermission(ctx, code) {
+    const user = requireUser(ctx);
+    if (!hasPermission(ctx, code))
+        throw new OneError(403, 'ONE-SDK-E-004', `Bu işlem için "${code}" izni gerekir.`);
+    return user;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/data/crud.d.ts

@@ -0,0 +1,74 @@
+import { OneError, type OneContext } from '../context.ts';
+import type { OneDatabase } from '../runtime.ts';
+import { type ExportLang } from '../export/columns.ts';
+import { type DataEntity, type DataField, type OneDataModel } from './model.ts';
+import { type DbValue, type FieldIssue } from './values.ts';
+export type CrudPermission = string | ((ctx: OneContext) => boolean);
+export interface CrudOptions {
+    /** `one data generate`'in ürettiği `dataModel` (ya da `one.data.json` içeriği). */
+    model: OneDataModel;
+    entity: string;
+    /** `shared`: uygulamayı kullanan herkes bütün kayıtları görür · `own`: herkes yalnız kendi oluşturduğu kayıtları. */
+    records: 'shared' | 'own';
+    /** Uçların öneki (varsayılan `/api`). */
+    basePath?: string;
+    /** Okuma için uygulama izni (ör. `One.Talep.Read`) ya da `(ctx) => boolean`; verilmezse oturum yeter. */
+    canRead?: CrudPermission;
+    /** Yazma (oluşturma, güncelleme, silme) için izin; verilmezse oturum yeter. */
+    canWrite?: CrudPermission;
+    /** Vekalet / Yerine Görüntüle oturumunda yazma (varsayılan `read` = kapalı). */
+    actingSessions?: 'read' | 'write';
+    /** Varsayılan sayfa boyu (1-200, varsayılan 50). */
+    pageSize?: number;
+    /** Dışa aktarmada en çok satır (varsayılan 10.000, en çok 50.000). */
+    exportLimit?: number;
+    /** Dışa aktarma ve raporda tarih-saatlerin gösterildiği saat dilimi (varsayılan Europe/Istanbul). */
+    timeZone?: string;
+}
+export interface CrudHandler {
+    /** Varlığın uç yolu (ör. `/api/requests`). */
+    readonly path: string;
+    /** İstek bu varlığın uçlarından birine değilse `null`; değilse yanıt (hatalar dahil — RFC 9457). */
+    handle(request: Request, db: OneDatabase, ctx?: OneContext): Promise<Response | null>;
+}
+export declare const CRUD_MAX_PAGE_SIZE = 200;
+export declare const CRUD_MAX_FILTERS = 20;
+export declare const CRUD_MAX_BODY_BYTES: number;
+export declare const CRUD_REPORT_MAX_ROWS = 2000;
+/** Alan hatalarını taşıyan hata — yanıtta RFC 9457 gövdesine `errors: [{ field, message }]` olarak eklenir. */
+export declare class DataValidationError extends OneError {
+    readonly errors: readonly FieldIssue[];
+    constructor(status: number, code: string, detail: string, errors: readonly FieldIssue[]);
+}
+/** Sorgu dizesi → WHERE parçaları + parametreler + sıralama + sayfa. Adlar yalnız modelden gelir. */
+export interface ListQuery {
+    where: string[];
+    params: DbValue[];
+    orderBy: string;
+    page: number;
+    size: number;
+    lang: ExportLang;
+}
+/**
+ * Hazır liste bileşeninin (`<one-table src>`, D-83) sorgu lehçesi → bu uçların lehçesi. Bileşen `limit` · `page` ·
+ * `cursor` · `sort` + `order` · `q` · `<alan>From` / `<alan>To` · `lang` gönderir; uçlar `_size` · `_page` · `_sort` ·
+ * `<alan>.contains` · `<alan>.from` / `<alan>.to` · `_lang` bekler. İki lehçe aynı uçta çalışır: bileşen `src` olarak
+ * doğrudan `/api/<varlık>` alabilir (D-82 şablonları bunu kullanır; önce 400 "Bilinmeyen sorgu parametresi" dönüyordu).
+ *
+ * ⚠️ Lehçe adı modeldeki bir ALAN adıysa (ör. alanın adı `page`) o parametre alan süzgecidir — model önceliklidir
+ * (geriye uyum). `q` metin alanlarının (text · longText) HERHANGİ birinde içerir araması yapar (Türkçe katlanmış,
+ * `.contains` ile aynı kural). `cursor` bu uçlarda sayfa numarasıdır (yanıttaki `nextCursor`).
+ */
+export declare function translateTableDialect(entity: DataEntity, params: URLSearchParams): {
+    params: URLSearchParams;
+    search: string | null;
+    issues: FieldIssue[];
+};
+export declare function parseListQuery(entity: DataEntity, raw: URLSearchParams, defaults: {
+    pageSize: number;
+}): ListQuery;
+/** Benzersizlik ihlali iletisinden (`UNIQUE constraint failed: <tablo>.<kolon>`) alanı bulur. */
+export declare function uniqueViolationField(entity: DataEntity, error: unknown): DataField | null | undefined;
+/** Model + varlık için uç işleyicisi. Model ilk kullanımda doğrulanır (geçersizse her istek 500 `ONE-SDK-E-100`). */
+export declare function createCrudHandler(options: CrudOptions): CrudHandler;
+//# sourceMappingURL=crud.d.ts.map

package/dist/data/crud.d.ts.map

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