{"id":42866,"library":"imes-aurora-postgres-store","title":"Imes Aurora Postgres Store","description":"Imes Aurora Postgres Store (v0.7.0) is a store implementation for the Imes identity and access management framework, optimized for Amazon Aurora PostgreSQL. It provides scalable, durable storage for Imes resources such as users, roles, and permissions. The store leverages Aurora's high availability and read replicas for performance. This package is part of the Imes ecosystem, which offers a modular approach to identity management. It requires the core `imes` package and `@aws-sdk/client-aurora-data-api` for direct Aurora Data API access. Release cadence follows Imes releases, with a focus on PostgreSQL compatibility.","status":"active","version":"0.7.0","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","typescript"],"install":[{"cmd":"npm install imes-aurora-postgres-store","lang":"bash","label":"npm"},{"cmd":"yarn add imes-aurora-postgres-store","lang":"bash","label":"yarn"},{"cmd":"pnpm add imes-aurora-postgres-store","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core Imes framework required for store integration","package":"imes","optional":false},{"reason":"Aurora Data API client for database operations","package":"@aws-sdk/client-aurora-data-api","optional":false},{"reason":"PostgreSQL client for traditional connection pool (fallback)","package":"pg","optional":true}],"imports":[{"note":"ESM-only; CommonJS require not supported. TypeScript types included.","wrong":"const AuroraPostgresStore = require('imes-aurora-postgres-store')","symbol":"AuroraPostgresStore","correct":"import { AuroraPostgresStore } from 'imes-aurora-postgres-store'"},{"note":"Type not exported. Use inline type or import from 'imes' package.","wrong":"import { AuroraPostgresStoreConfig } from 'imes-aurora-postgres-store'","symbol":"AuroraPostgresStoreConfig"},{"note":"Default export is not available; use named export.","wrong":"import createStore from 'imes-aurora-postgres-store'","symbol":"createStore","correct":"import { createStore } from 'imes-aurora-postgres-store'"}],"quickstart":{"code":"import { AuroraPostgresStore } from 'imes-aurora-postgres-store';\nimport { Imes } from 'imes';\n\nconst store = new AuroraPostgresStore({\n  secretArn: process.env.AURORA_SECRET_ARN ?? '',\n  resourceArn: process.env.AURORA_RESOURCE_ARN ?? '',\n  database: process.env.AURORA_DATABASE ?? 'imes',\n  region: 'us-east-1',\n});\n\nconst imes = new Imes({ store });\n\nasync function main() {\n  const user = await imes.users.create({ username: 'alice', attributes: { email: 'alice@example.com' } });\n  console.log('Created user:', user.id);\n}\n\nmain().catch(console.error);","lang":"typescript","description":"Initializes an AuroraPostgresStore with AWS Secrets Manager credentials and creates a user via Imes."},"warnings":[{"fix":"Add `region` to the configuration object when constructing AuroraPostgresStore.","message":"Required `region` configuration was added in v0.6.0; prior versions defaulted to 'us-east-1' but now must be explicitly set.","severity":"breaking","affected_versions":"<0.6.0"},{"fix":"Ensure ARNs are correct and the associated secret has the necessary permissions for the Aurora Data API.","message":"Store expects `secretArn` and `resourceArn` to be valid ARNs for AWS Secrets Manager and Aurora cluster. Invalid ARNs will cause silent failures with 'BadRequestException'.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Migrate to using `secretArn` + `resourceArn` + `database` configuration.","message":"The `connectionString` option is deprecated since v0.5.0; use `secretArn` and `resourceArn` instead.","severity":"deprecated","affected_versions":">=0.5.0"},{"fix":"Use 'imes-postgres-store' package for standard PostgreSQL; or upgrade to Aurora.","message":"Support for plain PostgreSQL (non-Aurora) via `pg` client was removed in v0.7.0. Only Aurora Data API is supported now.","severity":"breaking","affected_versions":">=0.7.0"}],"env_vars":null,"search_vec":"'/client-aurora-data-api':79 'access':19,85 'amazon':24 'api':84 'approach':65 'aurora':2,6,25,44,82 'avail':47 'aw':77 'aws-sdk':76 'cadenc':87 'compat':96 'core':72 'data':83 'direct':81 'durabl':30 'ecosystem':60 'focus':93 'follow':88 'framework':21 'high':46 'ident':17,67 'ime':1,5,16,33,59,73,89 'implement':13 'javascript':97 'leverag':43 'manag':20,68 'modular':64 'offer':62 'optim':22 'packag':54,74 'part':56 'perform':52 'permiss':40 'postgr':3,7 'postgresql':26,95 'provid':28 'read':49 'releas':86,90 'replica':50 'requir':70 'resourc':34 'role':38 'scalabl':29 'sdk':78 'storag':31 'store':4,8,12,42 'typescript':98 'user':37 'v0.7.0':9","created_at":"2026-06-05T16:57:02.776660+00:00","updated_at":"2026-06-05T16:57:02.776660+00:00","problems":[{"fix":"Run `npm install imes-aurora-postgres-store` and ensure import path is correct.","cause":"Package not installed or wrong import path.","error":"Error: Cannot find module 'imes-aurora-postgres-store'"},{"fix":"Change `import AuroraPostgresStore from ...` to `import { AuroraPostgresStore } from ...`.","cause":"Using default import instead of named import.","error":"TypeError: AuroraPostgresStore is not a constructor"},{"fix":"Provide `secretArn` and `resourceArn` in the constructor options.","cause":"Missing required configuration fields.","error":"Error: AuroraPostgresStore requires `secretArn` and `resourceArn` options"}],"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":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"imes-aurora-postgres-store","openapi_spec":null,"status_page":null,"smithery":null,"categories":["security","database"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-05","next_check":"2026-09-03","install_tag":null}}