{"id":25354163,"url":"https://github.com/owservable/folders","last_synced_at":"2026-01-21T00:33:55.953Z","repository":{"id":63807206,"uuid":"570849575","full_name":"owservable/folders","owner":"owservable","description":"owservable folders","archived":false,"fork":false,"pushed_at":"2025-11-10T08:45:35.000Z","size":832,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-10T08:47:54.186Z","etag":null,"topics":["owservable"],"latest_commit_sha":null,"homepage":"https://owservable.github.io/folders/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/owservable.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-11-26T10:33:01.000Z","updated_at":"2025-11-10T08:45:39.000Z","dependencies_parsed_at":"2026-01-06T02:04:14.974Z","dependency_job_id":null,"html_url":"https://github.com/owservable/folders","commit_stats":{"total_commits":14,"total_committers":1,"mean_commits":14.0,"dds":0.0,"last_synced_commit":"0029d2cfa29a63592de2bf063dd50f6f4efe0760"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/owservable/folders","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owservable%2Ffolders","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owservable%2Ffolders/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owservable%2Ffolders/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owservable%2Ffolders/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/owservable","download_url":"https://codeload.github.com/owservable/folders/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owservable%2Ffolders/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28619800,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T23:49:58.628Z","status":"ssl_error","status_checked_at":"2026-01-20T23:47:29.996Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["owservable"],"created_at":"2025-02-14T19:59:17.205Z","updated_at":"2026-01-21T00:33:55.948Z","avatar_url":"https://github.com/owservable.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"![owservable](https://avatars0.githubusercontent.com/u/87773159?s=75)\n\n# @owservable/folders\n\nA TypeScript utility library for file system operations, providing functions to work with folders and files recursively.\n\n## 🚀 Features\n\n- Recursively add files from folders\n- List subfolders by name with filtering\n- Get files from specific subfolders\n- Written in TypeScript with full type support\n- Lodash integration for efficient data manipulation\n\n## 📦 Installation\n\n```bash\nnpm install @owservable/folders\n```\n\nor\n\n```bash\nyarn add @owservable/folders\n```\n\nor\n\n```bash\npnpm add @owservable/folders\n```\n\n## 🔧 Usage\n\n### Basic Import\n\n```typescript\nimport {\n  addFilesFromFolder,\n  listSubfoldersByName,\n  listSubfoldersFilesByFolderName\n} from '@owservable/folders';\n```\n\n### Adding Files from Folder Recursively\n\n```typescript\nimport { addFilesFromFolder } from '@owservable/folders';\n\n// Initialize empty array to collect files\nconst files: string[] = [];\n\n// Add all files from a folder recursively\nconst allFiles = addFilesFromFolder(files, '/path/to/folder');\n\nconsole.log(allFiles); // Array of all file paths\n```\n\n### Listing Subfolders by Name\n\n```typescript\nimport { listSubfoldersByName } from '@owservable/folders';\n\n// Get all subfolders with specific name\nconst subfolders = listSubfoldersByName('/path/to/parent', 'targetFolderName');\n\nconsole.log(subfolders); // Array of matching subfolder paths\n```\n\n### Getting Files from Specific Subfolders\n\n```typescript\nimport { listSubfoldersFilesByFolderName } from '@owservable/folders';\n\n// Get all files from subfolders with specific name\nconst files = listSubfoldersFilesByFolderName('/path/to/parent', 'targetFolderName');\n\nconsole.log(files); // Array of file paths from matching subfolders\n```\n\n## 📚 API Documentation\n\n### `addFilesFromFolder(files: string[], folder: string): string[]`\n\nRecursively adds all files from a folder and its subfolders to the provided array.\n\n**Parameters:**\n- `files`: Array to store file paths\n- `folder`: Path to the folder to scan\n\n**Returns:** Array of file paths\n\n### `listSubfoldersByName(folder: string, name: string): string[]`\n\nLists all subfolders with a specific name within a given folder.\n\n**Parameters:**\n- `folder`: Path to the parent folder\n- `name`: Name of subfolders to find\n\n**Returns:** Array of matching subfolder paths\n\n### `listSubfoldersFilesByFolderName(folder: string, name: string): string[]`\n\nGets all files from subfolders that match a specific name.\n\n**Parameters:**\n- `folder`: Path to the parent folder\n- `name`: Name of subfolders to search in\n\n**Returns:** Array of file paths from matching subfolders\n\n## 🏗️ Requirements\n\n- Node.js \u003e= 20\n- TypeScript support\n\n## 🧪 Testing\n\n```bash\nnpm test\n```\n\n## 📖 Documentation\n\n- **TypeDoc Documentation**: [https://owservable.github.io/folders/docs/](https://owservable.github.io/folders/docs/)\n- **Test Coverage**: [https://owservable.github.io/folders/coverage/](https://owservable.github.io/folders/coverage/)\n\n## 🔗 Related Projects\n\n- [@owservable/actions](https://github.com/owservable/actions) - Action pattern implementation\n- [@owservable/fastify-auto-routes](https://github.com/owservable/fastify-auto-routes) - Fastify auto routing\n- [owservable](https://github.com/owservable/owservable) - Main reactive backend library\n\n## 📄 License\n\nLicensed under [The Unlicense](./LICENSE).\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fowservable%2Ffolders","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fowservable%2Ffolders","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fowservable%2Ffolders/lists"}