Replace axios with zero-dependency HTTP client

- Replace axios with built-in https module (zero dependencies)
- Add keep-alive agent (FIFO, 10 max sockets, 15s timeout)
- Add gzip/deflate/br decompression and 3xx redirect following
- Add 429 retry with backoff, skip retry on free-tier exhaustion
- Parse API error responses ({ status, error }) into structured errors
- Move config.js to config/index.js, remove unused io/downloadApiV1
- Move example.js to examples/scripts/playground.js, add 8 example scripts
- Add invalid API key test, module export tests (43 total)
- Update README links to match new repo (sec-api-io/sec-api-node)

Author: janlukasschroeder

.gitignore

@@ -4,4 +4,6 @@ node_modules
 deploy.sh
 .npmrc
 .claude
-tmp
+tmp
+TODO.md
+/scripts/*

README.md

@@ -883,7 +883,7 @@ const firms = await formAdvApi.getFirms({
 
 </details>
 
-[Full example response](https://github.com/janlukasschroeder/sec-api/blob/master/examples/api-responses/form-adv-firms.json)
+[Full example response](https://github.com/sec-api-io/sec-api-node/blob/master/examples/api-responses/form-adv-firms.json)
 
 ### Search Individual Advisors
 
@@ -965,7 +965,7 @@ const individuals = await formAdvApi.getIndividuals({
 
 </details>
 
-[Full example response](https://github.com/janlukasschroeder/sec-api/blob/master/examples/api-responses/form-adv-individuals.json)
+[Full example response](https://github.com/sec-api-io/sec-api-node/blob/master/examples/api-responses/form-adv-individuals.json)
 
 ### Get Direct Owners (Schedule A)
 
@@ -1005,7 +1005,7 @@ const directOwners = await formAdvApi.getDirectOwners('793');
 
 </details>
 
-[Full example response](https://github.com/janlukasschroeder/sec-api/blob/master/examples/api-responses/form-adv-direct-owners.json)
+[Full example response](https://github.com/sec-api-io/sec-api-node/blob/master/examples/api-responses/form-adv-direct-owners.json)
 
 ### Get Indirect Owners (Schedule B)
 
@@ -1047,7 +1047,7 @@ const indirectOwners = await formAdvApi.getIndirectOwners('326262');
 
 </details>
 
-[Full example response](https://github.com/janlukasschroeder/sec-api/blob/master/examples/api-responses/form-adv-indirect-owners.json)
+[Full example response](https://github.com/sec-api-io/sec-api-node/blob/master/examples/api-responses/form-adv-indirect-owners.json)
 
 ### Get Other Business Names (Schedule D, Section 1.B)
 
@@ -1097,7 +1097,7 @@ const otherBusinessNames = await formAdvApi.getOtherBusinessNames('149777');
 
 </details>
 
-[Full example response](https://github.com/janlukasschroeder/sec-api/blob/master/examples/api-responses/form-adv-other-business-names.json)
+[Full example response](https://github.com/sec-api-io/sec-api-node/blob/master/examples/api-responses/form-adv-other-business-names.json)
 
 ### Get Separately Managed Accounts (Schedule D, Section 5.K)
 
@@ -1154,7 +1154,7 @@ const smaData = await formAdvApi.getSeparatelyManagedAccounts('149777');
 
 </details>
 
-[Full example response](https://github.com/janlukasschroeder/sec-api/blob/master/examples/api-responses/form-adv-separately-managed-accounts.json)
+[Full example response](https://github.com/sec-api-io/sec-api-node/blob/master/examples/api-responses/form-adv-separately-managed-accounts.json)
 
 ### Get Financial Industry Affiliations (Schedule D, Section 7.A)
 
@@ -1191,7 +1191,7 @@ const affiliations =
 
 </details>
 
-[Full example response](https://github.com/janlukasschroeder/sec-api/blob/master/examples/api-responses/form-adv-financial-industry-affiliations.json)
+[Full example response](https://github.com/sec-api-io/sec-api-node/blob/master/examples/api-responses/form-adv-financial-industry-affiliations.json)
 
 ### Get Private Funds (Schedule D, Section 7.B.1)
 
@@ -1243,7 +1243,7 @@ const privateFunds = await formAdvApi.getPrivateFunds('793');
 
 </details>
 
-[Full example response](https://github.com/janlukasschroeder/sec-api/blob/master/examples/api-responses/form-adv-private-funds.json)
+[Full example response](https://github.com/sec-api-io/sec-api-node/blob/master/examples/api-responses/form-adv-private-funds.json)
 
 ### Get Brochures
 
@@ -1283,7 +1283,7 @@ const brochures = await formAdvApi.getBrochures('149777');
 
 </details>
 
-[Full example response](https://github.com/janlukasschroeder/sec-api/blob/master/examples/api-responses/form-adv-brochures.json)
+[Full example response](https://github.com/sec-api-io/sec-api-node/blob/master/examples/api-responses/form-adv-brochures.json)
 
 > See the documentation for more details: https://sec-api.io/docs/investment-adviser-and-adv-api
 

config.js config/index.jsconfig.js renamed to config/index.js

@@ -1,11 +1,4 @@
 module.exports = {
-  io: {
-    server: 'https://api.sec-api.io:3334',
-    // server: 'http://localhost:3333',
-    namespace: {
-      allFilings: 'all-filings',
-    },
-  },
   queryApi: {
     endpoint: 'https://api.sec-api.io',
   },

example.js

@@ -0,0 +1,31 @@
+const fs = require('fs');
+const path = require('path');
+const secApi = require('../../index');
+
+const { log } = console;
+
+// use .env if present, otherwise fall back to inline key
+let apiKey = 'YOUR_API_KEY';
+const envPath = path.join(__dirname, '..', '..', '.env');
+if (fs.existsSync(envPath)) {
+  const match = fs
+    .readFileSync(envPath, 'utf-8')
+    .match(/SEC_API_IO_API_KEY=(.+)/);
+  if (match) {
+    apiKey = match[1].trim();
+  }
+}
+secApi.setApiKey(apiKey);
+
+const main = async () => {
+  // download a 10-K filing as text
+  const content = await secApi.downloadApi.getFile(
+    'https://www.sec.gov/Archives/edgar/data/1318605/000162828025045968/tsla-20250930.htm',
+  );
+
+  log('Content type: ' + typeof content);
+  log('Content length: ' + content.length + ' characters');
+  log('First 200 chars:\n' + content.substring(0, 200));
+};
+
+main().catch(log);

examples/scripts/download-api.js

@@ -0,0 +1,32 @@
+const fs = require('fs');
+const path = require('path');
+const secApi = require('../../index');
+
+const { log } = console;
+
+// use .env if present, otherwise fall back to inline key
+let apiKey = 'YOUR_API_KEY';
+const envPath = path.join(__dirname, '..', '..', '.env');
+if (fs.existsSync(envPath)) {
+  const match = fs
+    .readFileSync(envPath, 'utf-8')
+    .match(/SEC_API_IO_API_KEY=(.+)/);
+  if (match) {
+    apiKey = match[1].trim();
+  }
+}
+secApi.setApiKey(apiKey);
+
+const main = async () => {
+  // extract "Risk Factors" (section 1A) from a Tesla 10-K
+  const text = await secApi.extractorApi.getSection(
+    'https://www.sec.gov/Archives/edgar/data/1318605/000156459021004599/tsla-10k_20201231.htm',
+    '1A',
+    'text',
+  );
+
+  log('Section 1A length: ' + text.length + ' characters');
+  log('First 500 chars:\n' + text.substring(0, 500));
+};
+
+main().catch(log);

examples/scripts/extractor-api.js

@@ -0,0 +1,38 @@
+const fs = require('fs');
+const path = require('path');
+const secApi = require('../../index');
+
+const { log } = console;
+
+// use .env if present, otherwise fall back to inline key
+let apiKey = 'YOUR_API_KEY';
+const envPath = path.join(__dirname, '..', '..', '.env');
+if (fs.existsSync(envPath)) {
+  const match = fs
+    .readFileSync(envPath, 'utf-8')
+    .match(/SEC_API_IO_API_KEY=(.+)/);
+  if (match) {
+    apiKey = match[1].trim();
+  }
+}
+secApi.setApiKey(apiKey);
+
+const main = async () => {
+  // Berkshire Hathaway 13F holdings (CIK: 1067983)
+  const result = await secApi.form13FHoldingsApi.getData({
+    query: 'cik:1067983',
+    from: '0',
+    size: '5',
+    sort: [{ filedAt: { order: 'desc' } }],
+  });
+
+  log('Total holdings filings: ' + result.total);
+
+  result.data.forEach((holding) => {
+    log(
+      holding.filedAt + ' | ' + holding.nameOfIssuer + ' | $' + holding.value,
+    );
+  });
+};
+
+main().catch(log);

examples/scripts/form-13f-api.js

@@ -0,0 +1,35 @@
+const fs = require('fs');
+const path = require('path');
+const secApi = require('../../index');
+
+const { log } = console;
+
+// use .env if present, otherwise fall back to inline key
+let apiKey = 'YOUR_API_KEY';
+const envPath = path.join(__dirname, '..', '..', '.env');
+if (fs.existsSync(envPath)) {
+  const match = fs
+    .readFileSync(envPath, 'utf-8')
+    .match(/SEC_API_IO_API_KEY=(.+)/);
+  if (match) {
+    apiKey = match[1].trim();
+  }
+}
+secApi.setApiKey(apiKey);
+
+const main = async () => {
+  const result = await secApi.fullTextSearchApi.getFilings({
+    query: '"artificial intelligence"',
+    formTypes: ['10-K', '10-Q'],
+    startDate: '2024-01-01',
+    endDate: '2024-12-31',
+  });
+
+  log('Total filings found: ' + JSON.stringify(result.total));
+
+  result.filings.forEach((filing) => {
+    log(filing.filedAt + ' | ' + filing.formType + ' | ' + filing.companyName);
+  });
+};
+
+main().catch(log);