{"id":47125,"library":"azure-storage-simple","title":"azure-storage-simple","description":"Simplified Promise-based interface for Azure Storage Services (Tables, Queues, Blob) for Node.js. Version 1.0.0 is the latest stable release. Wraps the official azure-storage SDK with a higher-level API that auto-creates resources, uses promises/async-await, and provides simplified table/queue/blob operations. Distinct from the official azure-storage SDK by offering a more concise interface focused on common patterns. Not actively maintained; last release was in 2016. Limited to Node.js (not browser-friendly).","status":"maintenance","version":"1.0.0","language":"javascript","source_language":"en","source_url":"https://github.com/tracker1/node-azure-storage-simple","tags":["javascript","azure","blob","table","queue","promise"],"install":[{"cmd":"npm install azure-storage-simple","lang":"bash","label":"npm"},{"cmd":"yarn add azure-storage-simple","lang":"bash","label":"yarn"},{"cmd":"pnpm add azure-storage-simple","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Underlying Azure Storage SDK for all API calls","package":"azure-storage","optional":false}],"imports":[{"note":"The module exports a function via default export. Named export does not exist.","wrong":"import { storage } from 'azure-storage-simple';","symbol":"default","correct":"import storage from 'azure-storage-simple';"},{"note":"Access the underlying azure-storage module through this subpath. It is a default export.","wrong":"import { azure } from 'azure-storage-simple/azure-storage';","symbol":"azure-storage module","correct":"import azure from 'azure-storage-simple/azure-storage';"},{"note":"The module exports a factory function; call it immediately with optional arguments. Do not separate require and invocation.","wrong":"const storage = require('azure-storage-simple'); storage();","symbol":"storage via require","correct":"const storage = require('azure-storage-simple')(account, key);"}],"quickstart":{"code":"const storage = require('azure-storage-simple')(process.env.AZURE_STORAGE_ACCOUNT, process.env.AZURE_STORAGE_ACCESS_KEY);\nconst queue = storage.queue('myqueue');\n\nasync function main() {\n  await queue.add({ message: 'Hello' });\n  const msg = await queue.one();\n  console.log(msg.value); // { message: 'Hello' }\n  await queue.done(msg);\n}\n\nmain().catch(console.error);","lang":"javascript","description":"Initializes storage with environment variables, creates a queue, adds and retrieves a message."},"warnings":[{"fix":"Set properties to null to remove them when writing a record.","message":"Write operations (tbl.write) use insertOrMerge semantics; to delete a property, set it to null explicitly.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Pre-create resources if you want to avoid the checks or use separate provisioning.","message":"The module auto-creates queues/tables on first use via createIfNotExist; this may incur extra latency and cost.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Always use record.value to get the unwrapped data.","message":"Returned records from read/query are wrapped objects; extract the raw value using .value property.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Consider migrating to '@azure/storage-blob', '@azure/storage-queue', '@azure/cosmos' (for tables) or the modern Azure SDK for JavaScript.","message":"Package is no longer actively maintained; last release 2016. Vulnerabilities in dependency 'azure-storage' may not be patched.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Check records.next existence and call await records.next() to fetch next page.","message":"Query results with more than 1000 items require pagination via .next() method; results loop may be confusing.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.0.0':20 '2016':76 'activ':70 'api':38 'auto':41 'auto-cr':40 'azur':2,11,30,56,85 'azure-storag':29,55 'azure-storage-simpl':1 'base':8 'blob':16,86 'browser':82 'browser-friend':81 'common':67 'concis':63 'creat':42 'distinct':51 'focus':65 'friend':83 'higher':36 'higher-level':35 'interfac':9,64 'javascript':84 'last':72 'latest':23 'level':37 'limit':77 'maintain':71 'node.js':18,79 'offer':60 'offici':28,54 'oper':50 'pattern':68 'promis':7,89 'promise-bas':6 'promises/async-await':45 'provid':47 'queue':15,88 'releas':25,73 'resourc':43 'sdk':32,58 'servic':13 'simpl':4 'simplifi':5,48 'stabl':24 'storag':3,12,31,57 'tabl':14,87 'table/queue/blob':49 'use':44 'version':19 'wrap':26","created_at":"2026-06-07T16:49:56.074172+00:00","updated_at":"2026-06-07T16:49:56.074172+00:00","problems":[{"fix":"Use: const storage = require('azure-storage-simple')(account, key);","cause":"Calling require('azure-storage-simple') without immediate invocation or using default import incorrectly.","error":"TypeError: storage is not a function"},{"fix":"Use: const azure = require('azure-storage-simple/azure-storage');","cause":"Path is case-sensitive or incorrect; must be exactly 'azure-storage-simple/azure-storage'.","error":"Cannot find module 'azure-storage-simple/azure-storage'"},{"fix":"Ensure AZURE_STORAGE_CONNECTION_STRING or account/key pair is correctly set and valid.","cause":"Often due to malformed connection string or missing environment variables.","error":"Error: The value for one of the XML nodes is not in the correct format."},{"fix":"Check if msg is defined before accessing .value.","cause":"Message not found or queue empty; .one() returns undefined if no message.","error":"TypeError: Cannot read property 'value' of undefined"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/tracker1/node-azure-storage-simple#readme","github":"https://github.com/tracker1/node-azure-storage-simple","docs":null,"changelog":null,"pypi":null,"npm":"azure-storage-simple","openapi_spec":null,"status_page":null,"smithery":null,"categories":["storage"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}