tiime-cli 1.1.0

package/dist/index.js

@@ -0,0 +1,694 @@
+// src/sdk/auth.ts
+import { execSync } from "child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { ofetch } from "ofetch";
+var AUTH0_DOMAIN = "auth0.tiime.fr";
+var AUTH0_CLIENT_ID = "iEbsbe3o66gcTBfGRa012kj1Rb6vjAND";
+var AUTH0_AUDIENCE = "https://chronos/";
+var CONFIG_DIR = join(homedir(), ".config", "tiime");
+var AUTH_FILE = join(CONFIG_DIR, "auth.json");
+var KEYCHAIN_ACCOUNT = "tiime-cli";
+var KEYCHAIN_SERVICE = "tiime-credentials";
+var saveCredentialsToKeychain = (email, password) => {
+  try {
+    const payload = JSON.stringify({ email, password });
+    execSync(
+      `security add-generic-password -a "${KEYCHAIN_ACCOUNT}" -s "${KEYCHAIN_SERVICE}" -w '${payload.replace(/'/g, "'\\''")}' -U`,
+      { stdio: "ignore" }
+    );
+    return true;
+  } catch {
+    return false;
+  }
+};
+var loadCredentialsFromKeychain = () => {
+  try {
+    const raw = execSync(
+      `security find-generic-password -a "${KEYCHAIN_ACCOUNT}" -s "${KEYCHAIN_SERVICE}" -w`,
+      { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }
+    ).trim();
+    const data = JSON.parse(raw);
+    if (typeof data === "object" && data !== null && "email" in data && "password" in data && typeof data.email === "string" && typeof data.password === "string") {
+      return data;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+};
+var saveCredentialsToFile = (email, password) => {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  const filePath = join(CONFIG_DIR, "credentials.json");
+  writeFileSync(filePath, JSON.stringify({ email, password }, null, 2), {
+    mode: 384
+  });
+};
+var loadCredentialsFromFile = () => {
+  try {
+    const filePath = join(CONFIG_DIR, "credentials.json");
+    if (existsSync(filePath)) {
+      const data = JSON.parse(readFileSync(filePath, "utf-8"));
+      if (typeof data === "object" && data !== null && "email" in data && "password" in data && typeof data.email === "string" && typeof data.password === "string") {
+        return data;
+      }
+    }
+  } catch {
+  }
+  return null;
+};
+var saveCredentials = (email, password) => {
+  if (!saveCredentialsToKeychain(email, password)) {
+    saveCredentialsToFile(email, password);
+  }
+};
+var loadCredentials = () => {
+  return loadCredentialsFromKeychain() ?? loadCredentialsFromFile();
+};
+var TokenManager = class {
+  tokens = null;
+  constructor() {
+    this.loadFromDisk();
+  }
+  async login(email, password) {
+    const response = await ofetch(`https://${AUTH0_DOMAIN}/oauth/token`, {
+      method: "POST",
+      body: {
+        grant_type: "password",
+        client_id: AUTH0_CLIENT_ID,
+        audience: AUTH0_AUDIENCE,
+        scope: "openid email",
+        username: email,
+        password
+      }
+    });
+    this.tokens = {
+      access_token: response.access_token,
+      expires_at: Date.now() + response.expires_in * 1e3
+    };
+    this.saveToDisk();
+    saveCredentials(email, password);
+    return this.tokens;
+  }
+  async getValidToken() {
+    if (!this.tokens || this.isExpired()) {
+      const creds = loadCredentials();
+      if (creds) {
+        const tokens = await this.login(creds.email, creds.password);
+        return tokens.access_token;
+      }
+      throw new Error(
+        this.tokens ? "Token expired. Run `tiime auth login` to re-authenticate." : "Not authenticated. Run `tiime auth login` first."
+      );
+    }
+    return this.tokens.access_token;
+  }
+  isAuthenticated() {
+    return this.tokens !== null && !this.isExpired();
+  }
+  logout() {
+    this.tokens = null;
+    if (existsSync(AUTH_FILE)) {
+      writeFileSync(AUTH_FILE, "{}");
+    }
+  }
+  getTokenInfo() {
+    if (!this.tokens) {
+      return { email: null, expiresAt: null };
+    }
+    try {
+      const payload = JSON.parse(
+        Buffer.from(
+          this.tokens.access_token.split(".")[1],
+          "base64"
+        ).toString()
+      );
+      return {
+        email: payload["tiime/userEmail"] || null,
+        expiresAt: new Date(this.tokens.expires_at)
+      };
+    } catch {
+      return { email: null, expiresAt: new Date(this.tokens.expires_at) };
+    }
+  }
+  isExpired() {
+    if (!this.tokens) return true;
+    return Date.now() >= this.tokens.expires_at - 6e4;
+  }
+  loadFromDisk() {
+    try {
+      if (existsSync(AUTH_FILE)) {
+        const data = JSON.parse(readFileSync(AUTH_FILE, "utf-8"));
+        if (data.access_token && data.expires_at) {
+          this.tokens = data;
+        }
+      }
+    } catch {
+    }
+  }
+  saveToDisk() {
+    if (!existsSync(CONFIG_DIR)) {
+      mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    writeFileSync(AUTH_FILE, JSON.stringify(this.tokens, null, 2));
+  }
+};
+
+// src/sdk/client.ts
+import { ofetch as ofetch2 } from "ofetch";
+
+// src/sdk/errors.ts
+var TiimeError = class extends Error {
+  constructor(message, status, endpoint, details) {
+    super(message);
+    this.status = status;
+    this.endpoint = endpoint;
+    this.details = details;
+    this.name = "TiimeError";
+  }
+  toJSON() {
+    return {
+      error: this.name,
+      message: this.message,
+      status: this.status,
+      endpoint: this.endpoint,
+      details: this.details
+    };
+  }
+};
+
+// src/sdk/resources/bank-accounts.ts
+var BankAccountsResource = class {
+  constructor(fetch, companyId) {
+    this.fetch = fetch;
+    this.companyId = companyId;
+  }
+  list(enabled) {
+    return this.fetch(
+      `/companies/${this.companyId}/bank_accounts`,
+      { query: enabled !== void 0 ? { enabled } : void 0 }
+    );
+  }
+  get(bankAccountId) {
+    return this.fetch(
+      `/companies/${this.companyId}/bank_accounts/${bankAccountId}`
+    );
+  }
+  async balance() {
+    const accounts = await this.list(true);
+    return accounts.map((a) => ({
+      name: a.name,
+      balance_amount: a.balance_amount,
+      currency: a.balance_currency
+    }));
+  }
+};
+
+// src/sdk/resources/bank-transactions.ts
+var BankTransactionsResource = class {
+  constructor(fetch, companyId) {
+    this.fetch = fetch;
+    this.companyId = companyId;
+  }
+  list(params) {
+    const start = ((params?.page ?? 1) - 1) * (params?.pageSize ?? 100);
+    const end = start + (params?.pageSize ?? 100);
+    const { page: _, pageSize: __, from, to, search, ...query } = params ?? {};
+    if (from) query.transaction_date_start = from;
+    if (to) query.transaction_date_end = to;
+    if (search) query.wording = search;
+    return this.fetch(
+      `/companies/${this.companyId}/bank_transactions`,
+      {
+        query: { hide_refused: false, ...query },
+        headers: {
+          Accept: "application/vnd.tiime.bank_transactions.v2+json,application/vnd.tiime.bank_transactions.without_documents+json",
+          Range: `items=${start}-${end}`
+        }
+      }
+    );
+  }
+  async listAll(params) {
+    const pageSize = params?.pageSize ?? 200;
+    const all = [];
+    let page = 1;
+    let hasMore = true;
+    while (hasMore) {
+      const response = await this.list({ ...params, page, pageSize });
+      all.push(...response.transactions);
+      hasMore = response.transactions.length === pageSize;
+      page++;
+    }
+    return all;
+  }
+  unimputed() {
+    return this.fetch(
+      `/companies/${this.companyId}/bank_transactions/unimputed`
+    );
+  }
+};
+
+// src/sdk/resources/clients.ts
+var ClientsResource = class {
+  constructor(fetch, companyId) {
+    this.fetch = fetch;
+    this.companyId = companyId;
+  }
+  list(params) {
+    return this.fetch(`/companies/${this.companyId}/clients`, {
+      query: params,
+      headers: {
+        Accept: "application/vnd.tiime.timeline.v2+json",
+        Range: "items=0-*"
+      }
+    });
+  }
+  get(clientId) {
+    return this.fetch(
+      `/companies/${this.companyId}/clients/${clientId}`
+    );
+  }
+  create(params) {
+    return this.fetch(`/companies/${this.companyId}/clients`, {
+      method: "POST",
+      body: params
+    });
+  }
+  search(query) {
+    return this.fetch(`/companies/${this.companyId}/clients`, {
+      query: { search: query },
+      headers: {
+        Accept: "application/vnd.tiime.timeline.v2+json",
+        Range: "items=0-*"
+      }
+    });
+  }
+};
+
+// src/sdk/resources/company.ts
+var CompanyResource = class {
+  constructor(fetch, companyId) {
+    this.fetch = fetch;
+    this.companyId = companyId;
+  }
+  get() {
+    return this.fetch(`/companies/${this.companyId}`);
+  }
+  users() {
+    return this.fetch(`/companies/${this.companyId}/users`);
+  }
+  appConfig() {
+    return this.fetch(`/companies/${this.companyId}/app_config`);
+  }
+  accountingPeriod(rangeYear = 1) {
+    return this.fetch(
+      `/companies/${this.companyId}/accounting_period/current`,
+      { query: { range_year: rangeYear } }
+    );
+  }
+  tiles(keys) {
+    return this.fetch(`/companies/${this.companyId}/tiles`, {
+      query: { keys: keys.join(",") }
+    });
+  }
+  dashboardBlocks(displayGroup = "monitoring") {
+    return this.fetch(`/companies/${this.companyId}/dashboard_blocks`, {
+      query: { sorts: "rank:asc", display_group: displayGroup }
+    });
+  }
+};
+
+// src/sdk/resources/documents.ts
+var DocumentsResource = class {
+  constructor(fetch, companyId) {
+    this.fetch = fetch;
+    this.companyId = companyId;
+  }
+  list(params) {
+    const start = ((params?.page ?? 1) - 1) * (params?.pageSize ?? 25);
+    const end = start + (params?.pageSize ?? 25);
+    const { page: _, pageSize: __, ...query } = params ?? {};
+    return this.fetch(`/companies/${this.companyId}/documents`, {
+      query: {
+        sorts: "created_at:desc",
+        expand: "file_family,preview_available",
+        ...query
+      },
+      headers: {
+        Accept: "application/vnd.tiime.documents.v2+json,application/vnd.tiime.docs.query+json,application/vnd.tiime.docs.imputation+json",
+        Range: `items=${start}-${end}`
+      }
+    });
+  }
+  categories() {
+    return this.fetch(
+      `/companies/${this.companyId}/document_categories`,
+      {
+        headers: {
+          Accept: "application/vnd.tiime.documents.v3+json"
+        }
+      }
+    );
+  }
+  preview(documentId) {
+    return this.fetch(
+      `/companies/${this.companyId}/documents/${documentId}/preview`
+    );
+  }
+  upload(file, filename, type) {
+    const formData = new FormData();
+    formData.append("file", new Blob([file]), filename);
+    if (type) {
+      formData.append("type", type);
+    }
+    return this.fetch(`/companies/${this.companyId}/documents`, {
+      method: "POST",
+      body: formData
+    });
+  }
+  async download(documentId) {
+    return this.fetch(
+      `/companies/${this.companyId}/documents/${documentId}/download`,
+      {
+        headers: { Accept: "application/octet-stream" }
+      }
+    );
+  }
+};
+
+// src/sdk/resources/expense-reports.ts
+var ExpenseReportsResource = class {
+  constructor(fetch, companyId) {
+    this.fetch = fetch;
+    this.companyId = companyId;
+  }
+  list(sorts = "metadata.date:desc") {
+    return this.fetch(
+      `/companies/${this.companyId}/expense_reports`,
+      {
+        query: { expand: "total_amount", sorts },
+        headers: { Range: "items=0-25" }
+      }
+    );
+  }
+  get(expenseReportId) {
+    return this.fetch(
+      `/companies/${this.companyId}/expense_reports/${expenseReportId}`
+    );
+  }
+  create(params) {
+    return this.fetch(
+      `/companies/${this.companyId}/expense_reports`,
+      {
+        method: "POST",
+        body: params
+      }
+    );
+  }
+};
+
+// src/sdk/resources/invoices.ts
+var DEFAULT_INVOICE_TEMPLATE = {
+  template: "advanced",
+  status: "draft",
+  due_date_mode: "thirty_days",
+  title_enabled: true,
+  free_field_enabled: false,
+  free_field: "",
+  discount_enabled: false,
+  bank_detail_enabled: true,
+  payment_condition_enabled: true,
+  payment_condition: "En cas de retard de paiement, une p\xE9nalit\xE9 de 3 fois le taux d'int\xE9r\xEAt l\xE9gal sera appliqu\xE9e, \xE0 laquelle s'ajoutera une indemnit\xE9 forfaitaire pour frais de recouvrement de 40\u20AC.",
+  text_lines: []
+};
+var InvoicesResource = class {
+  constructor(fetch, companyId) {
+    this.fetch = fetch;
+    this.companyId = companyId;
+  }
+  list(params) {
+    const start = ((params?.page ?? 1) - 1) * (params?.pageSize ?? 25);
+    const end = start + (params?.pageSize ?? 25);
+    const query = {
+      sorts: params?.sorts ?? "invoice_number:desc"
+    };
+    if (params?.status) query.status = params.status;
+    return this.fetch(`/companies/${this.companyId}/invoices`, {
+      query,
+      headers: { Range: `items=${start}-${end}` }
+    });
+  }
+  async listAll(params) {
+    const pageSize = params?.pageSize ?? 100;
+    const all = [];
+    let page = 1;
+    let hasMore = true;
+    while (hasMore) {
+      const batch = await this.list({
+        sorts: params?.sorts,
+        status: params?.status,
+        page,
+        pageSize
+      });
+      all.push(...batch);
+      hasMore = batch.length === pageSize;
+      page++;
+    }
+    return all;
+  }
+  get(invoiceId) {
+    return this.fetch(
+      `/companies/${this.companyId}/invoices/${invoiceId}`
+    );
+  }
+  create(params) {
+    const body = { ...DEFAULT_INVOICE_TEMPLATE, ...params };
+    for (const line of body.lines ?? []) {
+      line.line_amount = line.quantity * line.unit_amount;
+      line.sequence ??= 1;
+      line.invoicing_category_type ??= "benefit";
+      line.discount_description ??= "";
+      line.discount_amount ??= null;
+      line.discount_percentage ??= null;
+    }
+    return this.fetch(`/companies/${this.companyId}/invoices`, {
+      method: "POST",
+      body
+    });
+  }
+  update(invoiceId, params) {
+    return this.fetch(
+      `/companies/${this.companyId}/invoices/${invoiceId}`,
+      {
+        method: "PUT",
+        body: params
+      }
+    );
+  }
+  send(invoiceId, params) {
+    return this.fetch(
+      `/companies/${this.companyId}/invoices/${invoiceId}/send`,
+      {
+        method: "POST",
+        body: params
+      }
+    );
+  }
+  async downloadPdf(invoiceId) {
+    return this.fetch(
+      `/companies/${this.companyId}/invoices/${invoiceId}/pdf`,
+      {
+        headers: { Accept: "application/pdf" }
+      }
+    );
+  }
+  delete(invoiceId) {
+    return this.fetch(
+      `/companies/${this.companyId}/invoices/${invoiceId}`,
+      { method: "DELETE" }
+    );
+  }
+  async duplicate(invoiceId, overrides) {
+    const source = await this.get(invoiceId);
+    const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    const lines = source.lines.map((l) => ({
+      description: l.description,
+      quantity: overrides?.quantity ?? l.quantity,
+      unit_amount: l.unit_amount,
+      vat_type: l.vat_type,
+      invoicing_unit: l.invoicing_unit,
+      invoicing_category_type: l.invoicing_category_type,
+      article: l.article
+    }));
+    return this.create({
+      client: source.client_id ? { id: source.client_id } : null,
+      emission_date: overrides?.emission_date ?? today,
+      title: source.title,
+      title_enabled: !!source.title,
+      lines,
+      status: "draft"
+    });
+  }
+};
+
+// src/sdk/resources/labels.ts
+var LabelsResource = class {
+  constructor(fetch, companyId) {
+    this.fetch = fetch;
+    this.companyId = companyId;
+  }
+  list() {
+    return this.fetch(`/companies/${this.companyId}/labels`, {
+      headers: {
+        Accept: "application/vnd.tiime.labels.v2+json"
+      }
+    });
+  }
+  standard() {
+    return this.fetch(`/companies/${this.companyId}/standard_labels`);
+  }
+  tags() {
+    return this.fetch(`/companies/${this.companyId}/tags`, {
+      query: { expand: "tag_detail" }
+    });
+  }
+};
+
+// src/sdk/resources/quotations.ts
+var QuotationsResource = class {
+  constructor(fetch, companyId) {
+    this.fetch = fetch;
+    this.companyId = companyId;
+  }
+  list(expand = "invoices") {
+    return this.fetch(`/companies/${this.companyId}/quotations`, {
+      query: { expand },
+      headers: { Range: "items=0-25" }
+    });
+  }
+  get(quotationId) {
+    return this.fetch(
+      `/companies/${this.companyId}/quotations/${quotationId}`
+    );
+  }
+  create(params) {
+    return this.fetch(`/companies/${this.companyId}/quotations`, {
+      method: "POST",
+      body: params
+    });
+  }
+  async downloadPdf(quotationId) {
+    return this.fetch(
+      `/companies/${this.companyId}/quotations/${quotationId}/pdf`,
+      {
+        headers: { Accept: "application/pdf" }
+      }
+    );
+  }
+  send(quotationId, params) {
+    return this.fetch(
+      `/companies/${this.companyId}/quotations/${quotationId}/send`,
+      {
+        method: "POST",
+        body: params
+      }
+    );
+  }
+};
+
+// src/sdk/resources/users.ts
+var UsersResource = class {
+  constructor(fetch) {
+    this.fetch = fetch;
+  }
+  me() {
+    return this.fetch("/users/me");
+  }
+  legalInformations() {
+    return this.fetch("/users/me/legal_informations");
+  }
+  settings(companyId) {
+    return this.fetch(`/users/me/companies/${companyId}/settings`);
+  }
+};
+
+// src/sdk/client.ts
+var BASE_URL = "https://chronos-api.tiime-apps.com/v1";
+var TiimeClient = class {
+  fetch;
+  tokenManager;
+  companyId;
+  constructor(options) {
+    this.companyId = options.companyId;
+    this.tokenManager = options.tokenManager ?? new TokenManager();
+    this.fetch = ofetch2.create({
+      baseURL: BASE_URL,
+      retry: 2,
+      retryDelay: 500,
+      retryStatusCodes: [408, 429, 500, 502, 503, 504],
+      headers: {
+        "tiime-app": "tiime",
+        "tiime-app-version": "4.30.3",
+        "tiime-app-platform": "cli"
+      },
+      onRequest: async ({ options: options2 }) => {
+        const token = await this.tokenManager.getValidToken();
+        options2.headers.set("Authorization", `Bearer ${token}`);
+      },
+      onResponseError: ({ request, response }) => {
+        throw new TiimeError(
+          response.statusText || `HTTP ${response.status}`,
+          response.status,
+          String(request),
+          response._data
+        );
+      }
+    });
+  }
+  listCompanies() {
+    return this.fetch("/companies", {
+      headers: {
+        Accept: "application/vnd.tiime.companies.v2+json",
+        Range: "items=0-101"
+      }
+    });
+  }
+  get users() {
+    return new UsersResource(this.fetch);
+  }
+  get company() {
+    return new CompanyResource(this.fetch, this.companyId);
+  }
+  get clients() {
+    return new ClientsResource(this.fetch, this.companyId);
+  }
+  get invoices() {
+    return new InvoicesResource(this.fetch, this.companyId);
+  }
+  get quotations() {
+    return new QuotationsResource(this.fetch, this.companyId);
+  }
+  get bankAccounts() {
+    return new BankAccountsResource(this.fetch, this.companyId);
+  }
+  get bankTransactions() {
+    return new BankTransactionsResource(this.fetch, this.companyId);
+  }
+  get documents() {
+    return new DocumentsResource(this.fetch, this.companyId);
+  }
+  get expenseReports() {
+    return new ExpenseReportsResource(this.fetch, this.companyId);
+  }
+  get labels() {
+    return new LabelsResource(this.fetch, this.companyId);
+  }
+};
+export {
+  TiimeClient,
+  TiimeError,
+  TokenManager
+};