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

package/dist/data/values.d.ts

@@ -0,0 +1,29 @@
+import { type DataField } from './model.ts';
+export type DbValue = string | number | null;
+/** Bir alanın değer hatası (iletisi kullanıcıya gösterilebilir). */
+export interface FieldIssue {
+    field: string;
+    message: string;
+}
+export type Coerced = {
+    ok: true;
+    value: DbValue;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Yazılacak değer (gövdeden) → veritabanı değeri. `null`/`undefined`/boş metin "değer yok" sayılır; zorunluluk denetimi
+ * çağırandadır (oluştururken eksik alan, güncellemede gönderilmeyen alan farklı anlam taşır).
+ */
+export declare function coerceInput(f: DataField, raw: unknown): Coerced;
+/** Alan varsayılanının veritabanı değeri (yoksa `undefined`). */
+export declare function defaultDbValue(f: DataField): DbValue | undefined;
+/** Veritabanı değeri → API değeri (para: ondalıklı metin; evet/hayır: boolean). */
+export declare function outputValue(f: DataField, value: unknown): unknown;
+/**
+ * Süzgeç değeri (sorgu dizesinden) → veritabanı değeri. Eşitlik ve aralık için aynı kurallar; uzunluk sınırı yok
+ * sayılır (aranan değer kayıttan kısa olabilir), boş değer "değer yok" (IS NULL) anlamına gelmez — reddedilir.
+ */
+export declare function coerceFilter(f: DataField, raw: string): Coerced;
+//# sourceMappingURL=values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/data/values.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAiE,MAAM,YAAY,CAAA;AAG1G,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;AAE5C,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAmBnF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CA+D/D;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAIhE;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAKjE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAa/D"}

package/dist/data/values.js

@@ -0,0 +1,152 @@
+// Alan değerlerinin API ↔ veritabanı dönüşümü ve sunucu tarafı doğrulaması (D-84). Kurallar alan türüne göredir;
+// iletiler Türkçedir ve alanın görünen adını (title.tr) taşır — kullanıcıya doğrudan gösterilebilir.
+import { isCalendarDate, minorToMoney, moneyToMinor, normalizeDateTime } from './model.js';
+import { FILE_KEY_MAX_BYTES, FILE_KEY_MAX_LENGTH } from '../files.js';
+const PERSON_RE = /^[^\s\u0000-\u001f\u007f]{1,64}$/;
+// eslint-disable-next-line no-control-regex
+const SINGLE_LINE_BAD = /[\u0000-\u0008\u000a-\u001f\u007f]/;
+// eslint-disable-next-line no-control-regex
+const MULTI_LINE_BAD = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/;
+const codePoints = (s) => [...s].length;
+function fileKeyIssue(key) {
+    if (key.length === 0 || key.length > FILE_KEY_MAX_LENGTH || new TextEncoder().encode(key).byteLength > FILE_KEY_MAX_BYTES)
+        return `dosya anahtarı 1-${FILE_KEY_MAX_LENGTH} karakter olmalı`;
+    // eslint-disable-next-line no-control-regex
+    if (key.startsWith('/') || key.split('/').some((p) => p === '' || p === '.' || p === '..') || /[\u0000-\u001f\u007f]/.test(key))
+        return 'dosya anahtarı geçersiz';
+    return null;
+}
+/**
+ * Yazılacak değer (gövdeden) → veritabanı değeri. `null`/`undefined`/boş metin "değer yok" sayılır; zorunluluk denetimi
+ * çağırandadır (oluştururken eksik alan, güncellemede gönderilmeyen alan farklı anlam taşır).
+ */
+export function coerceInput(f, raw) {
+    const label = `"${f.title.tr}"`;
+    const fail = (m) => ({ ok: false, message: `${label} ${m}.` });
+    if (raw === null || raw === undefined)
+        return { ok: true, value: null };
+    switch (f.type) {
+        case 'text':
+        case 'longText': {
+            if (typeof raw !== 'string')
+                return fail('metin olmalı');
+            if (raw.trim() === '')
+                return { ok: true, value: null };
+            if ((f.type === 'text' ? SINGLE_LINE_BAD : MULTI_LINE_BAD).test(raw))
+                return fail(f.type === 'text' ? 'tek satır olmalı ve denetim karakteri içermemeli' : 'denetim karakteri içermemeli');
+            if (codePoints(raw) > f.maxLength)
+                return fail(`en çok ${f.maxLength} karakter olabilir`);
+            return { ok: true, value: raw };
+        }
+        case 'number': {
+            let n;
+            if (typeof raw === 'number')
+                n = raw;
+            else if (typeof raw === 'string' && /^\s*-?\d+(?:[.,]\d+)?\s*$/.test(raw))
+                n = Number(raw.trim().replace(',', '.'));
+            else if (typeof raw === 'string' && raw.trim() === '')
+                return { ok: true, value: null };
+            else
+                return fail('sayı olmalı');
+            if (!Number.isFinite(n))
+                return fail('sonlu bir sayı olmalı');
+            if (f.min !== undefined && n < f.min)
+                return fail(`en az ${f.min} olabilir`);
+            if (f.max !== undefined && n > f.max)
+                return fail(`en çok ${f.max} olabilir`);
+            return { ok: true, value: n };
+        }
+        case 'money': {
+            if (typeof raw === 'string' && raw.trim() === '')
+                return { ok: true, value: null };
+            if (typeof raw !== 'string' && typeof raw !== 'number')
+                return fail('tutar olmalı');
+            const minor = moneyToMinor(raw);
+            // Yuvarlama YAPILMAZ: iki basamaktan fazla ondalık, sessizce kesilmek yerine reddedilir.
+            if (minor === null)
+                return fail('en çok iki ondalık basamaklı bir tutar olmalı (ör. 1250.50; binlik ayırıcı kullanmayın)');
+            if (f.min !== undefined && minor < Math.round(f.min * 100))
+                return fail(`en az ${f.min} olabilir`);
+            if (f.max !== undefined && minor > Math.round(f.max * 100))
+                return fail(`en çok ${f.max} olabilir`);
+            return { ok: true, value: minor };
+        }
+        case 'boolean':
+            if (typeof raw !== 'boolean')
+                return fail('evet ya da hayır (true/false) olmalı');
+            return { ok: true, value: raw ? 1 : 0 };
+        case 'date':
+            if (typeof raw !== 'string')
+                return fail('tarih olmalı');
+            if (raw.trim() === '')
+                return { ok: true, value: null };
+            return isCalendarDate(raw) ? { ok: true, value: raw } : fail('YYYY-AA-GG biçiminde geçerli bir tarih olmalı');
+        case 'datetime': {
+            if (typeof raw !== 'string')
+                return fail('tarih-saat olmalı');
+            if (raw.trim() === '')
+                return { ok: true, value: null };
+            const iso = normalizeDateTime(raw);
+            return iso ? { ok: true, value: iso } : fail('saat dilimi belirtilmiş ISO biçiminde geçerli bir tarih-saat olmalı (ör. 2026-01-31T09:00:00Z)');
+        }
+        case 'choice':
+            if (typeof raw !== 'string')
+                return fail('seçeneklerden biri olmalı');
+            if (raw === '')
+                return { ok: true, value: null };
+            return f.choices.some((c) => c.value === raw) ? { ok: true, value: raw } : fail(`şunlardan biri olmalı: ${f.choices.map((c) => c.value).join(', ')}`);
+        case 'person':
+            if (typeof raw !== 'string')
+                return fail('kişi kimliği olmalı');
+            if (raw === '')
+                return { ok: true, value: null };
+            return PERSON_RE.test(raw) ? { ok: true, value: raw } : fail('geçerli bir kişi kimliği olmalı');
+        case 'file': {
+            if (typeof raw !== 'string')
+                return fail('dosya anahtarı olmalı');
+            if (raw === '')
+                return { ok: true, value: null };
+            const issue = fileKeyIssue(raw);
+            return issue ? fail(issue) : { ok: true, value: raw };
+        }
+    }
+}
+/** Alan varsayılanının veritabanı değeri (yoksa `undefined`). */
+export function defaultDbValue(f) {
+    if (f.default === undefined)
+        return undefined;
+    const c = coerceInput(f, f.default);
+    return c.ok ? c.value : undefined;
+}
+/** Veritabanı değeri → API değeri (para: ondalıklı metin; evet/hayır: boolean). */
+export function outputValue(f, value) {
+    if (value === null || value === undefined)
+        return null;
+    if (f.type === 'money')
+        return typeof value === 'number' ? minorToMoney(value) : null;
+    if (f.type === 'boolean')
+        return value === 1 || value === true;
+    return value;
+}
+/**
+ * Süzgeç değeri (sorgu dizesinden) → veritabanı değeri. Eşitlik ve aralık için aynı kurallar; uzunluk sınırı yok
+ * sayılır (aranan değer kayıttan kısa olabilir), boş değer "değer yok" (IS NULL) anlamına gelmez — reddedilir.
+ */
+export function coerceFilter(f, raw) {
+    if (raw === '')
+        return { ok: false, message: `"${f.title.tr}" süzgeci boş olamaz.` };
+    if (f.type === 'boolean') {
+        const v = raw.toLowerCase();
+        if (v === 'true' || v === '1')
+            return { ok: true, value: 1 };
+        if (v === 'false' || v === '0')
+            return { ok: true, value: 0 };
+        return { ok: false, message: `"${f.title.tr}" süzgeci true ya da false olmalı.` };
+    }
+    if (f.type === 'number' || f.type === 'money') {
+        // Süzgeçte min/max uygulanmaz (aralığın dışını aramak hata değildir).
+        return coerceInput({ ...f, min: undefined, max: undefined }, f.type === 'money' ? raw : raw);
+    }
+    return coerceInput({ ...f, maxLength: Number.MAX_SAFE_INTEGER }, raw);
+}
+//# sourceMappingURL=values.js.map

package/dist/data/values.js.map

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

package/dist/dexa.d.ts

@@ -0,0 +1,44 @@
+import type { BackendClient } from './backend.ts';
+/** QueryStore anahtarı biçimi; harf duyarlıdır (`IMS.X` ile `ims.x` ayrı anahtardır). Manifest şemasıyla birebir. */
+export declare const DEXA_KEY_RE: RegExp;
+/** Parametre adı biçimi (en çok 64 karakter). */
+export declare const DEXA_PARAMETER_NAME_RE: RegExp;
+export declare const DEXA_MAX_PARAMETERS = 32;
+export declare const DEXA_PARAMETER_VALUE_MAX_LENGTH = 2000;
+/** Platformun doldurduğu bağlam parametresi; uygulama GÖNDEREMEZ (harf duyarsız denetlenir, `ONE-SDK-E-043`). */
+export declare const DEXA_RESERVED_PARAMETERS: readonly ['LangCode'];
+/**
+ * Uygulamanın gönderebileceği bağlam parametreleri (C7). Sunucu yalnız kurulumda yönetici onayı varsa kabul eder; değer
+ * boş olamaz (harf duyarsız denetlenir, `ONE-SDK-E-140`).
+ */
+export declare const DEXA_APP_CONTEXT_PARAMETERS: readonly ['UserCode', 'CompanyCode', 'CostCenterCode'];
+export interface DexaQueryResult {
+    /** Sorgunun döndürdüğü kolon adları (sıra korunur). */
+    columns: string[];
+    /** Satırlar: kolon adı → değer. `unavailable` iken her zaman boştur ve "kayıt yok" anlamına GELMEZ. */
+    rows: Array<Record<string, unknown>>;
+    /** Sorgu çalışamadı (tünel yok / ERP'ye ulaşılamıyor / sorgu düştü) — "şu anda getirilemiyor". */
+    unavailable: boolean;
+    /** Sunucu sonucu 5.000 satırda kesti; liste eksiktir. */
+    truncated: boolean;
+}
+interface DexaQueryRequest {
+    key: string;
+    parameters?: Record<string, string>;
+}
+/** Sunucuya giden gövdeyi doğrular ve kurar; hatalı girdi fırlatır (istek hiç gitmez). */
+export declare function buildDexaQueryRequest(key: string, parameters?: Readonly<Record<string, string>>): DexaQueryRequest;
+/**
+ * Yanıtı savunmacı biçimde sözleşmeye indirger: eksik dizi → `[]`, eksik bayrak → `false` (sunucu varsayılan değerli
+ * alanı yazmayabilir). Gövde hiç nesne değilse (boş/bozuk yanıt) sonuç `unavailable: true` sayılır — bilinmeyen bir
+ * yanıtı "kayıt yok" diye göstermek tam olarak kaçınılan yanılgıdır.
+ */
+export declare function normalizeDexaQueryResult(raw: unknown): DexaQueryResult;
+/**
+ * Kayıt defterinde izinli, önceden tanımlı bir DEXA okuma sorgusunu çalıştırır. Kullanıcı, portal ve uygulama
+ * istekle GÖNDERİLMEZ — backend bunları doğrulanmış platform bağlamından alır. Sunucu hatası (`ONE-APP-E-0xx`)
+ * `OneError.code` ile olduğu gibi taşınır; `unavailable` bir hata DEĞİLDİR, sonuçta döner.
+ */
+export declare function queryDexa(api: Pick<BackendClient, 'request'>, key: string, parameters?: Readonly<Record<string, string>>): Promise<DexaQueryResult>;
+export {};
+//# sourceMappingURL=dexa.d.ts.map

package/dist/dexa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dexa.d.ts","sourceRoot":"","sources":["../src/dexa.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD,qHAAqH;AACrH,eAAO,MAAM,WAAW,QAAuC,CAAA;AAC/D,iDAAiD;AACjD,eAAO,MAAM,sBAAsB,QAAkC,CAAA;AACrE,eAAO,MAAM,mBAAmB,KAAK,CAAA;AACrC,eAAO,MAAM,+BAA+B,OAAO,CAAA;AACnD,iHAAiH;AACjH,eAAO,MAAM,wBAAwB,YAAI,UAAU,CAAU,CAAA;AAC7D;;;GAGG;AACH,eAAO,MAAM,2BAA2B,YAAI,UAAU,EAAE,aAAa,EAAE,gBAAgB,CAAU,CAAA;AAKjG,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,uGAAuG;IACvG,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACpC,kGAAkG;IAClG,WAAW,EAAE,OAAO,CAAA;IACpB,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,UAAU,gBAAgB;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,gBAAgB,CA4ClH;AAMD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAQtE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC5C,OAAO,CAAC,eAAe,CAAC,CAI1B"}

package/dist/dexa.js

@@ -0,0 +1,74 @@
+import { OneError } from './context.js';
+/** QueryStore anahtarı biçimi; harf duyarlıdır (`IMS.X` ile `ims.x` ayrı anahtardır). Manifest şemasıyla birebir. */
+export const DEXA_KEY_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+/** Parametre adı biçimi (en çok 64 karakter). */
+export const DEXA_PARAMETER_NAME_RE = /^[A-Za-z_][A-Za-z0-9_]{0,63}$/;
+export const DEXA_MAX_PARAMETERS = 32;
+export const DEXA_PARAMETER_VALUE_MAX_LENGTH = 2000;
+/** Platformun doldurduğu bağlam parametresi; uygulama GÖNDEREMEZ (harf duyarsız denetlenir, `ONE-SDK-E-043`). */
+export const DEXA_RESERVED_PARAMETERS = ['LangCode'];
+/**
+ * Uygulamanın gönderebileceği bağlam parametreleri (C7). Sunucu yalnız kurulumda yönetici onayı varsa kabul eder; değer
+ * boş olamaz (harf duyarsız denetlenir, `ONE-SDK-E-140`).
+ */
+export const DEXA_APP_CONTEXT_PARAMETERS = ['UserCode', 'CompanyCode', 'CostCenterCode'];
+const RESERVED_LOWER = new Set(DEXA_RESERVED_PARAMETERS.map((name) => name.toLowerCase()));
+const APP_CONTEXT_LOWER = new Set(DEXA_APP_CONTEXT_PARAMETERS.map((name) => name.toLowerCase()));
+/** Sunucuya giden gövdeyi doğrular ve kurar; hatalı girdi fırlatır (istek hiç gitmez). */
+export function buildDexaQueryRequest(key, parameters) {
+    if (typeof key !== 'string' || !DEXA_KEY_RE.test(key))
+        throw new OneError(400, 'ONE-SDK-E-040', 'DEXA sorgu anahtarı 1-128 karakter olmalı; harf ya da rakamla başlamalı ve yalnız harf, rakam, ".", "_", "-" içermelidir.');
+    const body = { key };
+    if (parameters === undefined)
+        return body;
+    if (parameters === null || typeof parameters !== 'object' || Array.isArray(parameters))
+        throw new OneError(400, 'ONE-SDK-E-041', 'DEXA sorgu parametreleri ad → metin değer eşlemesi (nesne) olmalıdır.');
+    const entries = Object.entries(parameters);
+    if (entries.length > DEXA_MAX_PARAMETERS)
+        throw new OneError(400, 'ONE-SDK-E-041', `DEXA sorgusuna en çok ${DEXA_MAX_PARAMETERS} parametre gönderilebilir (${entries.length}).`);
+    const out = {};
+    for (const [name, value] of entries) {
+        if (!DEXA_PARAMETER_NAME_RE.test(name))
+            throw new OneError(400, 'ONE-SDK-E-042', `DEXA parametre adı geçersiz: "${name}" — harf ya da "_" ile başlamalı, yalnız harf/rakam/"_" içermeli ve en çok 64 karakter olmalıdır.`);
+        if (RESERVED_LOWER.has(name.toLowerCase()))
+            throw new OneError(400, 'ONE-SDK-E-043', `"${name}" platformun doldurduğu bir bağlam parametresidir; uygulama gönderemez (${DEXA_RESERVED_PARAMETERS.join(', ')}).`);
+        if (typeof value !== 'string')
+            throw new OneError(400, 'ONE-SDK-E-044', `DEXA parametresi "${name}" metin olmalıdır (sayı ya da tarih String(...) ile çevrilir).`);
+        if (value.length > DEXA_PARAMETER_VALUE_MAX_LENGTH)
+            throw new OneError(400, 'ONE-SDK-E-044', `DEXA parametresi "${name}" en çok ${DEXA_PARAMETER_VALUE_MAX_LENGTH} karakter olabilir (${value.length}).`);
+        if (APP_CONTEXT_LOWER.has(name.toLowerCase()) && value.trim() === '')
+            throw new OneError(400, 'ONE-SDK-E-140', `DEXA bağlam parametresi "${name}" boş gönderilemez; boş değer ERP'ye gitmez. Değeri bilmiyorsanız parametreyi hiç göndermeyin.`);
+        out[name] = value;
+    }
+    body.parameters = out;
+    return body;
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * Yanıtı savunmacı biçimde sözleşmeye indirger: eksik dizi → `[]`, eksik bayrak → `false` (sunucu varsayılan değerli
+ * alanı yazmayabilir). Gövde hiç nesne değilse (boş/bozuk yanıt) sonuç `unavailable: true` sayılır — bilinmeyen bir
+ * yanıtı "kayıt yok" diye göstermek tam olarak kaçınılan yanılgıdır.
+ */
+export function normalizeDexaQueryResult(raw) {
+    if (!isRecord(raw))
+        return { columns: [], rows: [], unavailable: true, truncated: false };
+    return {
+        columns: Array.isArray(raw.columns) ? raw.columns.filter((c) => typeof c === 'string') : [],
+        rows: Array.isArray(raw.rows) ? raw.rows.filter(isRecord) : [],
+        unavailable: raw.unavailable === true,
+        truncated: raw.truncated === true,
+    };
+}
+/**
+ * Kayıt defterinde izinli, önceden tanımlı bir DEXA okuma sorgusunu çalıştırır. Kullanıcı, portal ve uygulama
+ * istekle GÖNDERİLMEZ — backend bunları doğrulanmış platform bağlamından alır. Sunucu hatası (`ONE-APP-E-0xx`)
+ * `OneError.code` ile olduğu gibi taşınır; `unavailable` bir hata DEĞİLDİR, sonuçta döner.
+ */
+export async function queryDexa(api, key, parameters) {
+    const body = buildDexaQueryRequest(key, parameters);
+    const raw = await api.request('One/services/dexa/query', { method: 'POST', body: JSON.stringify(body) });
+    return normalizeDexaQueryResult(raw);
+}
+//# sourceMappingURL=dexa.js.map

package/dist/dexa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dexa.js","sourceRoot":"","sources":["../src/dexa.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEvC,qHAAqH;AACrH,MAAM,CAAC,MAAM,WAAW,GAAG,oCAAoC,CAAA;AAC/D,iDAAiD;AACjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,+BAA+B,CAAA;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAA;AACrC,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAA;AACnD,iHAAiH;AACjH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,UAAU,CAAU,CAAA;AAC7D;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,gBAAgB,CAAU,CAAA;AAEjG,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS,wBAAwB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;AAClG,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS,2BAA2B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;AAkBxG,0FAA0F;AAC1F,MAAM,UAAU,qBAAqB,CAAC,GAAW,EAAE,UAA6C;IAC9F,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;QACnD,MAAM,IAAI,QAAQ,CAChB,GAAG,EACH,eAAe,EACf,2HAA2H,CAC5H,CAAA;IACH,MAAM,IAAI,GAAqB,EAAE,GAAG,EAAE,CAAA;IACtC,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IAEzC,IAAI,UAAU,KAAK,IAAI,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QACpF,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,eAAe,EAAE,uEAAuE,CAAC,CAAA;IACnH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IAC1C,IAAI,OAAO,CAAC,MAAM,GAAG,mBAAmB;QACtC,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,eAAe,EAAE,yBAAyB,mBAAmB,8BAA8B,OAAO,CAAC,MAAM,IAAI,CAAC,CAAA;IAExI,MAAM,GAAG,GAA2B,EAAE,CAAA;IACtC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;YACpC,MAAM,IAAI,QAAQ,CAChB,GAAG,EACH,eAAe,EACf,iCAAiC,IAAI,mGAAmG,CACzI,CAAA;QACH,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACxC,MAAM,IAAI,QAAQ,CAChB,GAAG,EACH,eAAe,EACf,IAAI,IAAI,2EAA2E,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAC3H,CAAA;QACH,IAAI,OAAO,KAAK,KAAK,QAAQ;YAC3B,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,eAAe,EAAE,qBAAqB,IAAI,gEAAgE,CAAC,CAAA;QACrI,IAAI,KAAK,CAAC,MAAM,GAAG,+BAA+B;YAChD,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,eAAe,EAAE,qBAAqB,IAAI,YAAY,+BAA+B,uBAAuB,KAAK,CAAC,MAAM,IAAI,CAAC,CAAA;QACvJ,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;YAClE,MAAM,IAAI,QAAQ,CAChB,GAAG,EACH,eAAe,EACf,4BAA4B,IAAI,gGAAgG,CACjI,CAAA;QACH,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IACnB,CAAC;IACD,IAAI,CAAC,UAAU,GAAG,GAAG,CAAA;IACrB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACnD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IACzF,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QACxG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QAC9D,WAAW,EAAE,GAAG,CAAC,WAAW,KAAK,IAAI;QACrC,SAAS,EAAE,GAAG,CAAC,SAAS,KAAK,IAAI;KAClC,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAmC,EACnC,GAAW,EACX,UAA6C;IAE7C,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IACnD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAU,yBAAyB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjH,OAAO,wBAAwB,CAAC,GAAG,CAAC,CAAA;AACtC,CAAC"}

package/dist/dexaCommand.d.ts

@@ -0,0 +1,116 @@
+import type { BackendClient } from './backend.ts';
+/** Komut parametre değerinin en çok uzunluğu (UTF-16 birimi). Sorgulardaki 2.000'den büyüktür: `Body` model JSON'u taşır. */
+export declare const DEXA_COMMAND_PARAMETER_VALUE_MAX_LENGTH = 65536;
+/** Kanonik UUID biçimi (harf duyarsız). Sunucu (`Guid.TryParse`) daha çok biçim kabul eder; SDK bilinçli olarak dardır. */
+export declare const IDEMPOTENCY_KEY_RE: RegExp;
+/** 200 yanıtının sonucu: `succeeded` · `rejected` (ERP reddetti; aynı içerikle tekrar denemek yine reddedilir) · `inDoubt`. */
+export type DexaCommandOutcome = 'succeeded' | 'rejected' | 'inDoubt';
+/** Durum ucunun genel komut sonuçları: yukarıdakiler + `pending` (sürüyor) + `notSent` (ERP'ye gönderilmedi). */
+export type DexaCommandStatusOutcome = DexaCommandOutcome | 'pending' | 'notSent';
+/** ERP yanıtının görünümü (backend `ErpCommandErpView`, alan adları birebir). */
+export interface DexaCommandErpView {
+    /** Tanınan yanıt şekli (backend `ErpResultShapes`: `envelope` · `nebimBody` · `rows` · `empty` · `unrecognized` · `agentError`). */
+    shape: string;
+    /** Sarmalın başarı bayrağı (yalnız `envelope` şeklinde dolu). */
+    isSuccessful: boolean | null;
+    /** ERP belge kimliği, tanındıysa. */
+    headerId: string | null;
+    /** ERP belge numarası, tanındıysa. */
+    documentNumber: string | null;
+    /** ERP/ajan hata mesajı (yığın izi yok). */
+    exceptionMessage: string | null;
+    /** Belge satırları, varsa. */
+    lines: unknown | null;
+    /** ERP'nin ham yanıtı (ayrıştırılmış ama değiştirilmemiş JSON); ajan hatasında ve sonuç gelmediğinde `null`. */
+    raw: unknown | null;
+}
+/** `runDexaCommand` sonucu (backend `ErpCommandResponse`, alan adları birebir). */
+export interface DexaCommandResult {
+    queryStoreKey: string;
+    /** Sunucunun kanonik (küçük harf) biçimiyle anahtar. */
+    idempotencyKey: string;
+    /** `true` = bu istekte ERP'ye GİDİLMEDİ; aynı anahtarın saklanan sonucu döndü. */
+    replayed: boolean;
+    outcome: DexaCommandOutcome;
+    /** DEXA ileti kimliği (destek/teşhis için); yoksa `null`. */
+    correlationId: string | null;
+    erp: DexaCommandErpView;
+}
+/** Bileşik komut adımı (backend `ErpCommandStepView`). One durum ucunda genel komut görünür; dizi boş gelir. */
+export interface DexaCommandStepView {
+    step: string;
+    key: string;
+    queryStoreKey: string;
+    role: string;
+    outcome: string;
+    correlationId: string | null;
+    erpMessage: string | null;
+    headerId: string | null;
+    documentNumber: string | null;
+}
+/** Bileşik komut uyarısı (backend `CompositeWarningView`). One durum ucunda dizi boş gelir. */
+export interface DexaCommandWarningView {
+    code: string;
+    message: string;
+    step: string | null;
+}
+/** `getDexaCommandStatus` sonucu (backend `ErpCommandStatusResponse`, alan adları birebir). */
+export interface DexaCommandStatus {
+    queryStoreKey: string;
+    idempotencyKey: string;
+    outcome: DexaCommandStatusOutcome;
+    correlationId: string | null;
+    /** Deneme sayısı (`notSent` sonrası yeniden denemeler dâhil). */
+    attemptCount: number;
+    /** İlk kayıt anı (ISO 8601, UTC). */
+    createdAtUtc: string;
+    /** Sonuçlanma anı (ISO 8601, UTC); sürüyorsa `null`. */
+    completedAtUtc: string | null;
+    /** ERP sonucu; sürüyorsa ya da gönderilmediyse `null`. */
+    erp: DexaCommandErpView | null;
+    steps: DexaCommandStepView[];
+    /** `command` (genel komut) · `composite` (bileşik komut). */
+    kind: string;
+    warnings: DexaCommandWarningView[];
+}
+interface DexaCommandRequest {
+    key: string;
+    parameters?: Record<string, string>;
+}
+/** Yeni bir kullanıcı eylemi için anahtar (`crypto.randomUUID`). Göndermeden ÖNCE kalıcı yere yazın. */
+export declare function newIdempotencyKey(): string;
+/** Anahtarı doğrular ve kanonik küçük harf biçimini döner; geçersizse fırlatır (istek hiç gitmez). */
+export declare function normalizeIdempotencyKey(idempotencyKey: string): string;
+/** Sunucuya giden gövdeyi doğrular ve kurar; hatalı girdi fırlatır (istek hiç gitmez). */
+export declare function buildDexaCommandRequest(key: string, parameters?: Readonly<Record<string, string>>): DexaCommandRequest;
+/**
+ * 200 yanıtını sözleşmeye indirger. ⛔ Sözleşmeye uymayan her yanıt — nesne olmayan gövde, bilinmeyen `outcome`, eksik
+ * ya da yanlış tipli alan, gönderilenden farklı `idempotencyKey` ya da `queryStoreKey` — `inDoubt` sayılır: ERP'ye
+ * gittiği kesin olan bir isteğin sonucu anlaşılamıyorsa onu başarı ya da ret saymak yanlış eylemi (yeni anahtarla
+ * tekrar → çift kayıt) tetikler. O durumda gövdenin HİÇBİR alanı sonuca taşınmaz (başka bir komuta ait olabilir):
+ * anahtarlar gönderilenlerdir, `replayed: false`, `correlationId: null`, `erp.shape: 'unrecognized'` — doğru sonuç AYNI
+ * anahtarla `getDexaCommandStatus` üzerinden okunur.
+ */
+export declare function normalizeDexaCommandResult(raw: unknown, sentIdempotencyKey: string, sentKey: string): DexaCommandResult;
+/**
+ * Durum yanıtını sözleşmeye indirger; doğrulama kuralı ve geri düşüş komut sonucuyla AYNIDIR (sözleşmeye uymayan
+ * yanıt `inDoubt`, gövdeden hiçbir alan taşınmaz; `queryStoreKey` bilinmediği için boş metindir).
+ */
+export declare function normalizeDexaCommandStatus(raw: unknown, sentIdempotencyKey: string): DexaCommandStatus;
+/**
+ * Kayıt defterinde izinli, önceden tanımlı bir DEXA komutunu çalıştırır — ERP'ye VERİ YAZAR (scope `dexa.write`).
+ * Kullanıcı, portal ve uygulama istekle GÖNDERİLMEZ; backend doğrulanmış platform bağlamından alır.
+ * 4xx hatası `OneError` olarak fırlar ve ERP'ye hiçbir şey gönderilmediği anlamına gelir; 409 `ERPCMD-APP-E-016`
+ * (`pending`) `OneError.retryAfterSeconds` taşır — o süre sonra AYNI anahtarla tekrar deneyin ya da durumu okuyun.
+ */
+export declare function runDexaCommand(api: Pick<BackendClient, 'request'>, key: string, parameters: Readonly<Record<string, string>> | undefined, options: {
+    idempotencyKey: string;
+}): Promise<DexaCommandResult>;
+/**
+ * Bu kullanıcının, bu uygulamanın izinli anahtarlarıyla çalıştırdığı bir komutun durumu (scope `dexa.write`).
+ * `null` = bu anahtarla görebileceğiniz bir kayıt yok (`404 ERPCMD-APP-E-017`): komut hiç kaydedilmemiştir, AYNI
+ * anahtarla yeniden gönderilebilir. Diğer her hata `OneError` olarak fırlar (eski backend'de uç yoksa da).
+ */
+export declare function getDexaCommandStatus(api: Pick<BackendClient, 'request'>, idempotencyKey: string): Promise<DexaCommandStatus | null>;
+export {};
+//# sourceMappingURL=dexaCommand.d.ts.map

package/dist/dexaCommand.d.ts.map

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