tiime-sdk 2.0.0 → 2.1.0

package/README.md

@@ -8,14 +8,39 @@ SDK TypeScript pour l'API de comptabilite [Tiime](https://www.tiime.fr) — inte
 npm install tiime-sdk
 ```
 
-## Pre-requis
+## Authentification
 
-Authentifiez-vous via le CLI [`tiime-cli`](https://www.npmjs.com/package/tiime-cli) :
+Le SDK fonctionne de maniere autonome. Plusieurs modes d'auth sont supportes :
+
+### Via variables d'environnement (recommande)
+
+```bash
+export TIIME_EMAIL=vous@example.com
+export TIIME_PASSWORD=votre-mot-de-passe
+export TIIME_COMPANY_ID=12345
+```
+
+```typescript
+import { TiimeClient } from "tiime-sdk";
+const client = new TiimeClient(); // tout est resolu automatiquement
+```
+
+### Via options explicites
+
+```typescript
+const client = new TiimeClient({
+  email: "vous@example.com",
+  password: "votre-mot-de-passe",
+  companyId: 12345,
+});
+```
+
+### Via le CLI (optionnel)
+
+Si [`tiime-cli`](https://www.npmjs.com/package/tiime-cli) est installe, le SDK utilise ses tokens automatiquement :
 
 ```bash
-npm install -g tiime-cli
-tiime auth login
-tiime company use --id 12345
+tiime auth login && tiime company use --id 12345
 ```
 
 ## Utilisation

package/dist/index.d.ts

@@ -9,8 +9,10 @@ interface AuthConfig {
     password: string;
 }
 interface TiimeClientOptions {
-    companyId: number;
+    companyId?: number;
     tokens?: AuthTokens;
+    email?: string;
+    password?: string;
 }
 interface Address {
     street: string;
@@ -422,9 +424,29 @@ interface MatchableDocument {
     }[];
 }
 
+/**
+ * Resolve companyId from multiple sources (in priority order):
+ * 1. Explicit option
+ * 2. TIIME_COMPANY_ID env var
+ * 3. ~/.config/tiime/config.json
+ */
+declare const resolveCompanyId: (explicit?: number) => number;
 declare class TokenManager {
     private tokens;
-    constructor();
+    private credentials;
+    private persist;
+    /**
+     * @param options.tokens - Use these tokens directly (no disk I/O)
+     * @param options.email - Login with these credentials
+     * @param options.password - Login with these credentials
+     * @param options.persist - Save tokens/credentials to disk (default: true when no explicit auth)
+     */
+    constructor(options?: {
+        tokens?: AuthTokens;
+        email?: string;
+        password?: string;
+        persist?: boolean;
+    });
     login(email: string, password: string): Promise<AuthTokens>;
     getValidToken(): Promise<string>;
     isAuthenticated(): boolean;
@@ -604,7 +626,7 @@ declare class TiimeClient {
     readonly fetch: $Fetch;
     readonly tokenManager: TokenManager;
     readonly companyId: number;
-    constructor(options: TiimeClientOptions & {
+    constructor(options?: TiimeClientOptions & {
         tokenManager?: TokenManager;
     });
     listCompanies(): Promise<Company[]>;
@@ -634,4 +656,4 @@ declare class TiimeError extends Error {
     };
 }
 
-export { type AccountingPeriod, type Address, type ApeCode, type AuthConfig, type AuthTokens, type Bank, type BankAccount, type BankTransaction, type BankTransactionsResponse, type Client, type Company, type Country, type DashboardBlock, type Document, type DocumentCategory, type DocumentMatching, type ExpenseReport, type ExpenseReportCreateParams, type Imputation, type ImputationLabel, type ImputationParams, type Invoice, type InvoiceCreateParams, type InvoiceLine, type InvoiceSendParams, type Label, type LabelSuggestion, type MatchableDocument, type PaginatedResponse, type Quotation, type QuotationCreateParams, type QuotationSendParams, type Tag, TiimeClient, type TiimeClientOptions, TiimeError, TokenManager, type User, type VatSystem };
+export { type AccountingPeriod, type Address, type ApeCode, type AuthConfig, type AuthTokens, type Bank, type BankAccount, type BankTransaction, type BankTransactionsResponse, type Client, type Company, type Country, type DashboardBlock, type Document, type DocumentCategory, type DocumentMatching, type ExpenseReport, type ExpenseReportCreateParams, type Imputation, type ImputationLabel, type ImputationParams, type Invoice, type InvoiceCreateParams, type InvoiceLine, type InvoiceSendParams, type Label, type LabelSuggestion, type MatchableDocument, type PaginatedResponse, type Quotation, type QuotationCreateParams, type QuotationSendParams, type Tag, TiimeClient, type TiimeClientOptions, TiimeError, TokenManager, type User, type VatSystem, resolveCompanyId };

package/dist/index.js

@@ -9,6 +9,7 @@ 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 CONFIG_FILE = join(CONFIG_DIR, "config.json");
 var KEYCHAIN_ACCOUNT = "tiime-cli";
 var KEYCHAIN_SERVICE = "tiime-credentials";
 var saveCredentialsToKeychain = (email, password) => {
@@ -68,9 +69,60 @@ var saveCredentials = (email, password) => {
 var loadCredentials = () => {
   return loadCredentialsFromKeychain() ?? loadCredentialsFromFile();
 };
+var resolveCompanyId = (explicit) => {
+  if (explicit) return explicit;
+  const envId = process.env.TIIME_COMPANY_ID;
+  if (envId) {
+    const parsed = Number.parseInt(envId, 10);
+    if (!Number.isNaN(parsed)) return parsed;
+  }
+  try {
+    if (existsSync(CONFIG_FILE)) {
+      const config = JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
+      if (config.companyId) return config.companyId;
+    }
+  } catch {
+  }
+  throw new Error(
+    "No company ID configured. Set TIIME_COMPANY_ID env var, pass companyId option, or run `tiime company use --id <ID>`."
+  );
+};
 var TokenManager = class {
   tokens = null;
-  constructor() {
+  credentials = null;
+  persist;
+  /**
+   * @param options.tokens - Use these tokens directly (no disk I/O)
+   * @param options.email - Login with these credentials
+   * @param options.password - Login with these credentials
+   * @param options.persist - Save tokens/credentials to disk (default: true when no explicit auth)
+   */
+  constructor(options = {}) {
+    const hasExplicitAuth = options.tokens || options.email && options.password;
+    this.persist = options.persist ?? !hasExplicitAuth;
+    if (options.tokens) {
+      this.tokens = options.tokens;
+      return;
+    }
+    if (options.email && options.password) {
+      this.credentials = { email: options.email, password: options.password };
+      return;
+    }
+    const envToken = process.env.TIIME_ACCESS_TOKEN;
+    if (envToken) {
+      this.tokens = {
+        access_token: envToken,
+        // No expiry info from env — assume valid, never auto-refresh
+        expires_at: Number.MAX_SAFE_INTEGER
+      };
+      return;
+    }
+    const envEmail = process.env.TIIME_EMAIL;
+    const envPassword = process.env.TIIME_PASSWORD;
+    if (envEmail && envPassword) {
+      this.credentials = { email: envEmail, password: envPassword };
+      return;
+    }
     this.loadFromDisk();
   }
   async login(email, password) {
@@ -89,19 +141,21 @@ var TokenManager = class {
       access_token: response.access_token,
       expires_at: Date.now() + response.expires_in * 1e3
     };
-    this.saveToDisk();
-    saveCredentials(email, password);
+    if (this.persist) {
+      this.saveToDisk();
+      saveCredentials(email, password);
+    }
     return this.tokens;
   }
   async getValidToken() {
     if (!this.tokens || this.isExpired()) {
-      const creds = loadCredentials();
+      const creds = this.credentials ?? 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."
+        this.tokens ? "Token expired. Provide credentials via options, TIIME_EMAIL/TIIME_PASSWORD env vars, or run `tiime auth login`." : "Not authenticated. Provide credentials via options, TIIME_EMAIL/TIIME_PASSWORD env vars, or run `tiime auth login`."
       );
     }
     return this.tokens.access_token;
@@ -679,9 +733,13 @@ var TiimeClient = class {
   fetch;
   tokenManager;
   companyId;
-  constructor(options) {
-    this.companyId = options.companyId;
-    this.tokenManager = options.tokenManager ?? new TokenManager();
+  constructor(options = {}) {
+    this.companyId = resolveCompanyId(options.companyId);
+    this.tokenManager = options.tokenManager ?? new TokenManager({
+      tokens: options.tokens,
+      email: options.email,
+      password: options.password
+    });
     this.fetch = ofetch2.create({
       baseURL: BASE_URL,
       retry: 2,
@@ -748,5 +806,6 @@ var TiimeClient = class {
 export {
   TiimeClient,
   TiimeError,
-  TokenManager
+  TokenManager,
+  resolveCompanyId
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiime-sdk",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "TypeScript SDK for Tiime accounting API",
   "type": "module",
   "main": "./dist/index.js",