@doow/track 0.1.4 → 0.1.9

package/dist/cjs/exporter.js

@@ -25,7 +25,7 @@ async function gzipBuffer(data) {
         gz.end(data);
     });
 }
-const SDK_VERSION = "0.1.4";
+const SDK_VERSION = "0.1.9";
 function toWireEvent(event) {
     var _a;
     const sourceSystem = ((_a = event.source_system) === null || _a === void 0 ? void 0 : _a.trim()) ? event.source_system : 'sdk';

package/dist/cjs/index.js

@@ -2,9 +2,12 @@
 
 var tracker = require('./tracker.js');
 var fileOfflineStore = require('./file-offline-store.js');
+var management = require('./management.js');
 
 
 
 exports.DoowTracker = tracker.DoowTracker;
 exports.FileOfflineStore = fileOfflineStore.FileOfflineStore;
+exports.DoowManagement = management.DoowManagement;
+exports.ManagementApiError = management.ManagementApiError;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;"}

package/dist/cjs/management.js

@@ -0,0 +1,244 @@
+'use strict';
+
+/**
+ * DoowManagement — CRUD operations for apps, contracts, licenses, and metrics
+ *
+ * Usage:
+ *   import { DoowManagement } from '@doow/track';
+ *   const mgmt = new DoowManagement('dk_your_api_key');
+ *
+ *   // Create an app
+ *   const app = await mgmt.apps.create({ name: 'My SaaS' });
+ *
+ *   // Create a contract under the app
+ *   const contract = await mgmt.contracts.create(app.id, { title: 'Enterprise Plan' });
+ *
+ *   // Create a license under the contract
+ *   const license = await mgmt.licenses.create(contract.id, { name: 'API Usage' });
+ *
+ *   // Create a metric under the license
+ *   const metric = await mgmt.metrics.create(license.id, { metric_type: 'api_calls' });
+ */
+const DEFAULT_ENDPOINT = 'https://api.doow.co';
+const DEFAULT_TIMEOUT = 30000;
+class ManagementApiError extends Error {
+    constructor(error) {
+        super(error.message);
+        this.name = 'ManagementApiError';
+        this.status = error.status;
+        if (error.code !== undefined)
+            this.code = error.code;
+        if (error.details !== undefined)
+            this.details = error.details;
+    }
+}
+class DoowManagement {
+    constructor(apiKey, options = {}) {
+        var _a, _b, _c;
+        if (!apiKey.startsWith('dk_')) {
+            console.warn(`[doow/management] API key must start with "dk_". Got: "${apiKey.slice(0, 10)}..."`);
+        }
+        this._apiKey = apiKey;
+        this._endpoint = (_a = options.endpoint) !== null && _a !== void 0 ? _a : DEFAULT_ENDPOINT;
+        this._timeout = (_b = options.timeout) !== null && _b !== void 0 ? _b : DEFAULT_TIMEOUT;
+        this._debug = (_c = options.debug) !== null && _c !== void 0 ? _c : false;
+        this.apps = new AppsClient(this);
+        this.contracts = new ContractsClient(this);
+        this.licenses = new LicensesClient(this);
+        this.metrics = new MetricsClient(this);
+        this.expenses = new ExpensesClient(this);
+    }
+    log(message) {
+        if (this._debug) {
+            console.log(`[doow/management] ${message}`);
+        }
+    }
+    async request(method, path, body, query) {
+        const url = new URL(`${this._endpoint}${path}`);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${this._apiKey}`,
+            'Content-Type': 'application/json',
+            'User-Agent': '@doow/track-sdk',
+        };
+        this.log(`${method} ${url.pathname}${url.search}`);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this._timeout);
+        try {
+            const fetchOptions = {
+                method,
+                headers,
+                signal: controller.signal,
+            };
+            if (body) {
+                fetchOptions.body = JSON.stringify(body);
+            }
+            const response = await fetch(url.toString(), fetchOptions);
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                let errorBody;
+                try {
+                    errorBody = (await response.json());
+                }
+                catch {
+                    errorBody = {
+                        status: response.status,
+                        message: response.statusText || `HTTP ${response.status}`,
+                    };
+                }
+                errorBody.status = response.status;
+                throw new ManagementApiError(errorBody);
+            }
+            if (response.status === 204) {
+                return undefined;
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof ManagementApiError) {
+                throw error;
+            }
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new ManagementApiError({
+                    status: 0,
+                    message: `Request timeout after ${this._timeout}ms`,
+                    code: 'TIMEOUT',
+                });
+            }
+            throw new ManagementApiError({
+                status: 0,
+                message: error instanceof Error ? error.message : 'Network error',
+                code: 'NETWORK_ERROR',
+            });
+        }
+    }
+}
+// ─── Apps Client ───────────────────────────────────────────────────────────
+class AppsClient {
+    constructor(mgmt) {
+        this.mgmt = mgmt;
+    }
+    async create(input) {
+        return this.mgmt.request('POST', '/sdk/apps', input);
+    }
+    async list(params = {}) {
+        return this.mgmt.request('GET', '/sdk/apps', undefined, {
+            cursor: params.cursor,
+            limit: params.limit,
+            name: params.name,
+        });
+    }
+    async get(id) {
+        return this.mgmt.request('GET', `/sdk/apps/${id}`);
+    }
+    async update(id, input) {
+        return this.mgmt.request('PUT', `/sdk/apps/${id}`, input);
+    }
+    async delete(id) {
+        return this.mgmt.request('DELETE', `/sdk/apps/${id}`);
+    }
+}
+// ─── Contracts Client ──────────────────────────────────────────────────────
+class ContractsClient {
+    constructor(mgmt) {
+        this.mgmt = mgmt;
+    }
+    async create(appId, input) {
+        return this.mgmt.request('POST', `/sdk/apps/${appId}/contracts`, input);
+    }
+    async listByApp(appId, params = {}) {
+        return this.mgmt.request('GET', `/sdk/apps/${appId}/contracts`, undefined, {
+            cursor: params.cursor,
+            limit: params.limit,
+            contract_type: params.contract_type,
+        });
+    }
+    async get(id) {
+        return this.mgmt.request('GET', `/sdk/contracts/${id}`);
+    }
+    async update(id, input) {
+        return this.mgmt.request('PUT', `/sdk/contracts/${id}`, input);
+    }
+    async delete(id) {
+        return this.mgmt.request('DELETE', `/sdk/contracts/${id}`);
+    }
+}
+// ─── Licenses Client ───────────────────────────────────────────────────────
+class LicensesClient {
+    constructor(mgmt) {
+        this.mgmt = mgmt;
+    }
+    async create(contractId, input) {
+        return this.mgmt.request('POST', `/sdk/contracts/${contractId}/licenses`, input);
+    }
+    async listByContract(contractId, params = {}) {
+        return this.mgmt.request('GET', `/sdk/contracts/${contractId}/licenses`, undefined, {
+            cursor: params.cursor,
+            limit: params.limit,
+            license_type: params.license_type,
+        });
+    }
+    async get(id) {
+        return this.mgmt.request('GET', `/sdk/licenses/${id}`);
+    }
+    async update(id, input) {
+        return this.mgmt.request('PUT', `/sdk/licenses/${id}`, input);
+    }
+    async delete(id) {
+        return this.mgmt.request('DELETE', `/sdk/licenses/${id}`);
+    }
+}
+// ─── Metrics Client ────────────────────────────────────────────────────────
+class MetricsClient {
+    constructor(mgmt) {
+        this.mgmt = mgmt;
+    }
+    async create(licenseId, input) {
+        return this.mgmt.request('POST', `/sdk/licenses/${licenseId}/metrics`, input);
+    }
+    async listByLicense(licenseId, params = {}) {
+        return this.mgmt.request('GET', `/sdk/licenses/${licenseId}/metrics`, undefined, {
+            cursor: params.cursor,
+            limit: params.limit,
+            metric_type: params.metric_type,
+        });
+    }
+    async get(id) {
+        return this.mgmt.request('GET', `/sdk/metrics/${id}`);
+    }
+    async update(id, input) {
+        return this.mgmt.request('PUT', `/sdk/metrics/${id}`, input);
+    }
+    async delete(id) {
+        return this.mgmt.request('DELETE', `/sdk/metrics/${id}`);
+    }
+}
+class ExpensesClient {
+    constructor(mgmt) {
+        this.mgmt = mgmt;
+    }
+    async list(params = {}) {
+        return this.mgmt.request('GET', '/sdk/expenses', undefined, {
+            cursor: params.cursor,
+            limit: params.limit,
+            app_id: params.app_id,
+            contract_id: params.contract_id,
+            year: params.year,
+            month: params.month,
+        });
+    }
+    async get(id) {
+        return this.mgmt.request('GET', `/sdk/expenses/${id}`);
+    }
+}
+
+exports.DoowManagement = DoowManagement;
+exports.ManagementApiError = ManagementApiError;
+//# sourceMappingURL=management.js.map

package/dist/cjs/management.js.map

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

package/dist/cli.cjs

@@ -69,7 +69,7 @@ async function gzipBuffer(data) {
         gz.end(data);
     });
 }
-const SDK_VERSION = "0.1.4";
+const SDK_VERSION = "0.1.9";
 function toWireEvent(event) {
     var _a;
     const sourceSystem = ((_a = event.source_system) === null || _a === void 0 ? void 0 : _a.trim()) ? event.source_system : 'sdk';

package/dist/esm/exporter.js

@@ -23,7 +23,7 @@ async function gzipBuffer(data) {
         gz.end(data);
     });
 }
-const SDK_VERSION = "0.1.4";
+const SDK_VERSION = "0.1.9";
 function toWireEvent(event) {
     var _a;
     const sourceSystem = ((_a = event.source_system) === null || _a === void 0 ? void 0 : _a.trim()) ? event.source_system : 'sdk';

package/dist/esm/index.js

@@ -1,3 +1,4 @@
 export { DoowTracker } from './tracker.js';
 export { FileOfflineStore } from './file-offline-store.js';
+export { DoowManagement, ManagementApiError } from './management.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/management.js

@@ -0,0 +1,241 @@
+/**
+ * DoowManagement — CRUD operations for apps, contracts, licenses, and metrics
+ *
+ * Usage:
+ *   import { DoowManagement } from '@doow/track';
+ *   const mgmt = new DoowManagement('dk_your_api_key');
+ *
+ *   // Create an app
+ *   const app = await mgmt.apps.create({ name: 'My SaaS' });
+ *
+ *   // Create a contract under the app
+ *   const contract = await mgmt.contracts.create(app.id, { title: 'Enterprise Plan' });
+ *
+ *   // Create a license under the contract
+ *   const license = await mgmt.licenses.create(contract.id, { name: 'API Usage' });
+ *
+ *   // Create a metric under the license
+ *   const metric = await mgmt.metrics.create(license.id, { metric_type: 'api_calls' });
+ */
+const DEFAULT_ENDPOINT = 'https://api.doow.co';
+const DEFAULT_TIMEOUT = 30000;
+class ManagementApiError extends Error {
+    constructor(error) {
+        super(error.message);
+        this.name = 'ManagementApiError';
+        this.status = error.status;
+        if (error.code !== undefined)
+            this.code = error.code;
+        if (error.details !== undefined)
+            this.details = error.details;
+    }
+}
+class DoowManagement {
+    constructor(apiKey, options = {}) {
+        var _a, _b, _c;
+        if (!apiKey.startsWith('dk_')) {
+            console.warn(`[doow/management] API key must start with "dk_". Got: "${apiKey.slice(0, 10)}..."`);
+        }
+        this._apiKey = apiKey;
+        this._endpoint = (_a = options.endpoint) !== null && _a !== void 0 ? _a : DEFAULT_ENDPOINT;
+        this._timeout = (_b = options.timeout) !== null && _b !== void 0 ? _b : DEFAULT_TIMEOUT;
+        this._debug = (_c = options.debug) !== null && _c !== void 0 ? _c : false;
+        this.apps = new AppsClient(this);
+        this.contracts = new ContractsClient(this);
+        this.licenses = new LicensesClient(this);
+        this.metrics = new MetricsClient(this);
+        this.expenses = new ExpensesClient(this);
+    }
+    log(message) {
+        if (this._debug) {
+            console.log(`[doow/management] ${message}`);
+        }
+    }
+    async request(method, path, body, query) {
+        const url = new URL(`${this._endpoint}${path}`);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${this._apiKey}`,
+            'Content-Type': 'application/json',
+            'User-Agent': '@doow/track-sdk',
+        };
+        this.log(`${method} ${url.pathname}${url.search}`);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this._timeout);
+        try {
+            const fetchOptions = {
+                method,
+                headers,
+                signal: controller.signal,
+            };
+            if (body) {
+                fetchOptions.body = JSON.stringify(body);
+            }
+            const response = await fetch(url.toString(), fetchOptions);
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                let errorBody;
+                try {
+                    errorBody = (await response.json());
+                }
+                catch {
+                    errorBody = {
+                        status: response.status,
+                        message: response.statusText || `HTTP ${response.status}`,
+                    };
+                }
+                errorBody.status = response.status;
+                throw new ManagementApiError(errorBody);
+            }
+            if (response.status === 204) {
+                return undefined;
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof ManagementApiError) {
+                throw error;
+            }
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new ManagementApiError({
+                    status: 0,
+                    message: `Request timeout after ${this._timeout}ms`,
+                    code: 'TIMEOUT',
+                });
+            }
+            throw new ManagementApiError({
+                status: 0,
+                message: error instanceof Error ? error.message : 'Network error',
+                code: 'NETWORK_ERROR',
+            });
+        }
+    }
+}
+// ─── Apps Client ───────────────────────────────────────────────────────────
+class AppsClient {
+    constructor(mgmt) {
+        this.mgmt = mgmt;
+    }
+    async create(input) {
+        return this.mgmt.request('POST', '/sdk/apps', input);
+    }
+    async list(params = {}) {
+        return this.mgmt.request('GET', '/sdk/apps', undefined, {
+            cursor: params.cursor,
+            limit: params.limit,
+            name: params.name,
+        });
+    }
+    async get(id) {
+        return this.mgmt.request('GET', `/sdk/apps/${id}`);
+    }
+    async update(id, input) {
+        return this.mgmt.request('PUT', `/sdk/apps/${id}`, input);
+    }
+    async delete(id) {
+        return this.mgmt.request('DELETE', `/sdk/apps/${id}`);
+    }
+}
+// ─── Contracts Client ──────────────────────────────────────────────────────
+class ContractsClient {
+    constructor(mgmt) {
+        this.mgmt = mgmt;
+    }
+    async create(appId, input) {
+        return this.mgmt.request('POST', `/sdk/apps/${appId}/contracts`, input);
+    }
+    async listByApp(appId, params = {}) {
+        return this.mgmt.request('GET', `/sdk/apps/${appId}/contracts`, undefined, {
+            cursor: params.cursor,
+            limit: params.limit,
+            contract_type: params.contract_type,
+        });
+    }
+    async get(id) {
+        return this.mgmt.request('GET', `/sdk/contracts/${id}`);
+    }
+    async update(id, input) {
+        return this.mgmt.request('PUT', `/sdk/contracts/${id}`, input);
+    }
+    async delete(id) {
+        return this.mgmt.request('DELETE', `/sdk/contracts/${id}`);
+    }
+}
+// ─── Licenses Client ───────────────────────────────────────────────────────
+class LicensesClient {
+    constructor(mgmt) {
+        this.mgmt = mgmt;
+    }
+    async create(contractId, input) {
+        return this.mgmt.request('POST', `/sdk/contracts/${contractId}/licenses`, input);
+    }
+    async listByContract(contractId, params = {}) {
+        return this.mgmt.request('GET', `/sdk/contracts/${contractId}/licenses`, undefined, {
+            cursor: params.cursor,
+            limit: params.limit,
+            license_type: params.license_type,
+        });
+    }
+    async get(id) {
+        return this.mgmt.request('GET', `/sdk/licenses/${id}`);
+    }
+    async update(id, input) {
+        return this.mgmt.request('PUT', `/sdk/licenses/${id}`, input);
+    }
+    async delete(id) {
+        return this.mgmt.request('DELETE', `/sdk/licenses/${id}`);
+    }
+}
+// ─── Metrics Client ────────────────────────────────────────────────────────
+class MetricsClient {
+    constructor(mgmt) {
+        this.mgmt = mgmt;
+    }
+    async create(licenseId, input) {
+        return this.mgmt.request('POST', `/sdk/licenses/${licenseId}/metrics`, input);
+    }
+    async listByLicense(licenseId, params = {}) {
+        return this.mgmt.request('GET', `/sdk/licenses/${licenseId}/metrics`, undefined, {
+            cursor: params.cursor,
+            limit: params.limit,
+            metric_type: params.metric_type,
+        });
+    }
+    async get(id) {
+        return this.mgmt.request('GET', `/sdk/metrics/${id}`);
+    }
+    async update(id, input) {
+        return this.mgmt.request('PUT', `/sdk/metrics/${id}`, input);
+    }
+    async delete(id) {
+        return this.mgmt.request('DELETE', `/sdk/metrics/${id}`);
+    }
+}
+class ExpensesClient {
+    constructor(mgmt) {
+        this.mgmt = mgmt;
+    }
+    async list(params = {}) {
+        return this.mgmt.request('GET', '/sdk/expenses', undefined, {
+            cursor: params.cursor,
+            limit: params.limit,
+            app_id: params.app_id,
+            contract_id: params.contract_id,
+            year: params.year,
+            month: params.month,
+        });
+    }
+    async get(id) {
+        return this.mgmt.request('GET', `/sdk/expenses/${id}`);
+    }
+}
+
+export { DoowManagement, ManagementApiError };
+//# sourceMappingURL=management.js.map

package/dist/esm/management.js.map

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

package/dist/sidecar.cjs

@@ -71,7 +71,7 @@ async function gzipBuffer(data) {
         gz.end(data);
     });
 }
-const SDK_VERSION = "0.1.4";
+const SDK_VERSION = "0.1.9";
 function toWireEvent(event) {
     var _a;
     const sourceSystem = ((_a = event.source_system) === null || _a === void 0 ? void 0 : _a.trim()) ? event.source_system : 'sdk';

package/dist/types/index.d.ts

@@ -220,5 +220,371 @@ declare class FileOfflineStore implements OfflineStore {
     get directory(): string;
 }
 
-export { DoowTracker, FileOfflineStore };
-export type { BatchPayload, CustomTransport, DoowTrackerOptions, OfflineStore, PartialAcceptResponse, RateLimit, SdkError, SdkErrorKind, SerializedBatch, SerializedEvent, TrackEvent, TransportPayload, TransportResponse };
+/**
+ * Types for SDK Management API (CRUD operations for apps, contracts, licenses, metrics)
+ */
+interface PaginationParams {
+    cursor?: string;
+    limit?: number;
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    cursor?: string;
+    has_more: boolean;
+}
+interface CreateAppInput {
+    name: string;
+    description?: string;
+    website?: string;
+    logo_url?: string;
+    categories?: string[];
+}
+interface UpdateAppInput {
+    name?: string;
+    description?: string;
+    website?: string;
+    logo_url?: string;
+    categories?: string[];
+}
+interface App {
+    id: string;
+    name: string;
+    description?: string;
+    website?: string;
+    logo_url?: string;
+    categories?: string[];
+    saas_application_id: string;
+    created_at: string;
+    updated_at: string;
+}
+interface ListAppsParams extends PaginationParams {
+    name?: string;
+}
+type ContractType = 'PAY_AS_YOU_GO' | 'ENTERPRISE' | 'UNKNOWN';
+type CostAmortization = 'PRORATA' | 'MONTHS' | 'QUARTER' | 'YEARS';
+interface Expense {
+    id: string;
+    app_id: string | null;
+    contract_id: string | null;
+    license_id: string | null;
+    total: number;
+    date: string;
+    month: number;
+    year: number;
+    description: string | null;
+    transaction_id: string | null;
+    vendor: string | null;
+    payment_channel: string | null;
+    created_at: string;
+    updated_at: string | null;
+}
+interface ListExpensesParams extends PaginationParams {
+    app_id?: string;
+    contract_id?: string;
+    year?: number;
+    month?: number;
+}
+/**
+ * Input for creating a license inline with a contract.
+ *
+ * SDK only supports USAGE_BASED licenses — SEAT_BASED must be created via UI.
+ * total_cost is optional (calculated from usage metrics).
+ */
+interface LicenseInput {
+    name: string;
+    /** Defaults to USAGE_BASED. SDK only supports USAGE_BASED. */
+    license_type?: LicenseType;
+    seats?: number;
+    price_per_seat?: number;
+    total_cost?: number;
+    discount?: Record<string, unknown>;
+    discount_amount?: number;
+    discounted_cost?: number;
+    original_cost?: number;
+    tenure?: number;
+    seats_included_in_base_plan?: number;
+}
+/**
+ * License in contract response. Uses AllLicenseType since responses may include
+ * UI-created SEAT_BASED licenses.
+ */
+interface LicenseInContract {
+    id: string;
+    name: string;
+    license_type: AllLicenseType;
+    seats?: number;
+    price_per_seat?: number;
+    total_cost?: number;
+    discount?: Record<string, unknown>;
+    discount_amount?: number;
+    discounted_cost?: number;
+    original_cost?: number;
+    tenure?: number;
+    seats_included_in_base_plan?: number;
+}
+interface CreateContractInput {
+    title?: string;
+    contract_type?: ContractType;
+    start_date?: string;
+    end_date?: string;
+    currency?: string;
+    cost?: number;
+    cost_break_down?: Record<string, unknown>;
+    cost_amortization?: CostAmortization;
+    add_ons?: Record<string, unknown>;
+    add_ons_total_cost?: number;
+    total_contract_cost?: number;
+    total_discount_amount?: number;
+    total_original_cost?: number;
+    licenses: LicenseInput[];
+    expense_ids?: string[];
+}
+interface UpdateContractInput {
+    title?: string;
+    contract_type?: ContractType;
+    start_date?: string;
+    end_date?: string;
+    currency?: string;
+    cost?: number;
+    cost_break_down?: Record<string, unknown>;
+    cost_amortization?: CostAmortization;
+    add_ons?: Record<string, unknown>;
+    add_ons_total_cost?: number;
+    total_contract_cost?: number;
+    total_discount_amount?: number;
+    total_original_cost?: number;
+}
+interface Contract {
+    id: string;
+    app_id: string;
+    title: string;
+    contract_type: ContractType;
+    start_date?: string;
+    end_date?: string;
+    currency?: string;
+    cost?: number;
+    cost_break_down?: Record<string, unknown>;
+    cost_amortization?: CostAmortization;
+    add_ons?: Record<string, unknown>;
+    add_ons_total_cost?: number;
+    total_contract_cost?: number;
+    total_discount_amount?: number;
+    total_original_cost?: number;
+    licenses?: LicenseInContract[];
+    expenses?: Expense[];
+    created_at: string;
+    updated_at: string;
+}
+interface ListContractsParams extends PaginationParams {
+    contract_type?: ContractType;
+}
+/**
+ * License types for SDK creation. SDK only supports USAGE_BASED.
+ * SEAT_BASED licenses must be created via the UI.
+ */
+type LicenseType = 'USAGE_BASED';
+/**
+ * All license types (for responses that may include UI-created licenses)
+ */
+type AllLicenseType = 'USAGE_BASED' | 'SEAT_BASED' | 'PREPAID_CREDITS' | 'FLAT_RATE';
+interface CreateLicenseInput {
+    name: string;
+    license_type?: LicenseType;
+    seats?: number;
+    price_per_seat?: number;
+    total_cost?: number;
+    discount?: Record<string, unknown>;
+    discount_amount?: number;
+    discounted_cost?: number;
+    original_cost?: number;
+    tenure?: number;
+    seats_included_in_base_plan?: number;
+}
+interface UpdateLicenseInput {
+    name?: string;
+    license_type?: LicenseType;
+    seats?: number;
+    price_per_seat?: number;
+    total_cost?: number;
+    discount?: Record<string, unknown>;
+    discount_amount?: number;
+    discounted_cost?: number;
+    original_cost?: number;
+    tenure?: number;
+    seats_included_in_base_plan?: number;
+}
+/**
+ * License response. Uses AllLicenseType since responses may include
+ * UI-created SEAT_BASED licenses.
+ */
+interface License {
+    id: string;
+    contract_id: string;
+    name: string;
+    license_type: AllLicenseType;
+    seats?: number;
+    price_per_seat?: number;
+    total_cost?: number;
+    discount?: Record<string, unknown>;
+    discount_amount?: number;
+    discounted_cost?: number;
+    original_cost?: number;
+    tenure?: number;
+    seats_included_in_base_plan?: number;
+}
+interface ListLicensesParams extends PaginationParams {
+    license_type?: AllLicenseType;
+}
+type UsageAggregationType = 'SUM' | 'MAX' | 'CUMULATIVE';
+type RateKind = 'PER_UNIT' | 'FLAT_FEE' | 'PER_SEAT' | 'TIERED' | 'VOLUME';
+type EntitlementPeriod = 'MONTHLY' | 'YEARLY' | 'QUARTERLY' | 'WEEKLY' | 'DAILY' | 'ONE_TIME';
+type CarryoverPolicy = 'EXPIRE_AT_PERIOD_END' | 'ROLLOVER' | 'ROLLOVER_CAPPED';
+interface CreateMetricInput {
+    metric_type: string;
+    usage_aggregation_type?: UsageAggregationType;
+    rate_kind?: RateKind;
+    entitlement_period?: EntitlementPeriod;
+    carryover_policy?: CarryoverPolicy;
+    usage_rate?: number;
+    usage_limit?: number;
+    usage_included?: number;
+    per_unit_cap?: number;
+    usage_rate_is_estimated?: boolean;
+    usage_custom_unit_label?: string;
+    expected_emission_interval_minutes?: number;
+}
+interface UpdateMetricInput {
+    metric_type?: string;
+    usage_aggregation_type?: UsageAggregationType;
+    rate_kind?: RateKind;
+    entitlement_period?: EntitlementPeriod;
+    carryover_policy?: CarryoverPolicy;
+    usage_rate?: number;
+    usage_limit?: number;
+    usage_included?: number;
+    per_unit_cap?: number;
+    usage_rate_is_estimated?: boolean;
+    usage_custom_unit_label?: string;
+    expected_emission_interval_minutes?: number;
+}
+interface Metric {
+    id: string;
+    license_id: string;
+    metric_type: string;
+    usage_aggregation_type: UsageAggregationType;
+    rate_kind: RateKind;
+    entitlement_period: EntitlementPeriod;
+    carryover_policy: CarryoverPolicy;
+    usage_rate?: number;
+    usage_limit?: number;
+    usage_included?: number;
+    per_unit_cap?: number;
+    usage_rate_is_estimated?: boolean;
+    usage_custom_unit_label?: string;
+    expected_emission_interval_minutes?: number;
+    created_at: string;
+    updated_at: string;
+}
+interface ListMetricsParams extends PaginationParams {
+    metric_type?: string;
+}
+interface DoowManagementOptions {
+    /** Server endpoint. Default: https://api.doow.co */
+    endpoint?: string;
+    /** Request timeout in ms. Default: 30000 */
+    timeout?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+interface ApiError {
+    status: number;
+    message: string;
+    code?: string;
+    details?: Record<string, unknown>;
+}
+
+/**
+ * DoowManagement — CRUD operations for apps, contracts, licenses, and metrics
+ *
+ * Usage:
+ *   import { DoowManagement } from '@doow/track';
+ *   const mgmt = new DoowManagement('dk_your_api_key');
+ *
+ *   // Create an app
+ *   const app = await mgmt.apps.create({ name: 'My SaaS' });
+ *
+ *   // Create a contract under the app
+ *   const contract = await mgmt.contracts.create(app.id, { title: 'Enterprise Plan' });
+ *
+ *   // Create a license under the contract
+ *   const license = await mgmt.licenses.create(contract.id, { name: 'API Usage' });
+ *
+ *   // Create a metric under the license
+ *   const metric = await mgmt.metrics.create(license.id, { metric_type: 'api_calls' });
+ */
+
+declare class ManagementApiError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(error: ApiError);
+}
+declare class DoowManagement {
+    private readonly _apiKey;
+    private readonly _endpoint;
+    private readonly _timeout;
+    private readonly _debug;
+    readonly apps: AppsClient;
+    readonly contracts: ContractsClient;
+    readonly licenses: LicensesClient;
+    readonly metrics: MetricsClient;
+    readonly expenses: ExpensesClient;
+    constructor(apiKey: string, options?: DoowManagementOptions);
+    private log;
+    request<T>(method: string, path: string, body?: Record<string, unknown>, query?: Record<string, string | number | undefined>): Promise<T>;
+}
+declare class AppsClient {
+    private readonly mgmt;
+    constructor(mgmt: DoowManagement);
+    create(input: CreateAppInput): Promise<App>;
+    list(params?: ListAppsParams): Promise<PaginatedResponse<App>>;
+    get(id: string): Promise<App>;
+    update(id: string, input: UpdateAppInput): Promise<App>;
+    delete(id: string): Promise<void>;
+}
+declare class ContractsClient {
+    private readonly mgmt;
+    constructor(mgmt: DoowManagement);
+    create(appId: string, input: CreateContractInput): Promise<Contract>;
+    listByApp(appId: string, params?: ListContractsParams): Promise<PaginatedResponse<Contract>>;
+    get(id: string): Promise<Contract>;
+    update(id: string, input: UpdateContractInput): Promise<Contract>;
+    delete(id: string): Promise<void>;
+}
+declare class LicensesClient {
+    private readonly mgmt;
+    constructor(mgmt: DoowManagement);
+    create(contractId: string, input: CreateLicenseInput): Promise<License>;
+    listByContract(contractId: string, params?: ListLicensesParams): Promise<PaginatedResponse<License>>;
+    get(id: string): Promise<License>;
+    update(id: string, input: UpdateLicenseInput): Promise<License>;
+    delete(id: string): Promise<void>;
+}
+declare class MetricsClient {
+    private readonly mgmt;
+    constructor(mgmt: DoowManagement);
+    create(licenseId: string, input: CreateMetricInput): Promise<Metric>;
+    listByLicense(licenseId: string, params?: ListMetricsParams): Promise<PaginatedResponse<Metric>>;
+    get(id: string): Promise<Metric>;
+    update(id: string, input: UpdateMetricInput): Promise<Metric>;
+    delete(id: string): Promise<void>;
+}
+declare class ExpensesClient {
+    private readonly mgmt;
+    constructor(mgmt: DoowManagement);
+    list(params?: ListExpensesParams): Promise<PaginatedResponse<Expense>>;
+    get(id: string): Promise<Expense>;
+}
+
+export { DoowManagement, DoowTracker, FileOfflineStore, ManagementApiError };
+export type { ApiError, App, BatchPayload, CarryoverPolicy, Contract, ContractType, CostAmortization, CreateAppInput, CreateContractInput, CreateLicenseInput, CreateMetricInput, CustomTransport, DoowManagementOptions, DoowTrackerOptions, EntitlementPeriod, Expense, License, LicenseInContract, LicenseInput, LicenseType, ListAppsParams, ListContractsParams, ListExpensesParams, ListLicensesParams, ListMetricsParams, Metric, OfflineStore, PaginatedResponse, PaginationParams, PartialAcceptResponse, RateKind, RateLimit, SdkError, SdkErrorKind, SerializedBatch, SerializedEvent, TrackEvent, TransportPayload, TransportResponse, UpdateAppInput, UpdateContractInput, UpdateLicenseInput, UpdateMetricInput, UsageAggregationType };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doow/track",
-  "version": "0.1.4",
+  "version": "0.1.9",
   "description": "Customer-facing SDK for emitting usage telemetry to Doow",
   "license": "MIT",
   "author": "Doow",