npm - @vyriy/services - Versions diffs - 0.1.9 - Mend

@vyriy/services 0.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (54) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Vyriy contributors
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,100 @@
+# @vyriy/services
+Small AWS service SDK for Vyriy projects.
+## Purpose
+This package wraps common AWS SDK operations behind calm, reusable helpers.
+It is not meant to hide AWS. It keeps the AWS command inputs available where
+they are useful, while removing repeated client setup and common boilerplate
+from app, script, service, and deployment code.
+The package is AWS-first and serverless-oriented. Current helpers cover:
+- `cloudfront`: create invalidations and optionally wait for completion
+- `dynamodb`: create tables and read/write/query/scan document items
+- `ecs`: start one Fargate task with environment overrides
+- `lambda`: invoke Lambda functions with JSON string payloads
+- `s3`: upload, download, and check object existence
+- `sns`: publish messages to topics
+- `ssm`: read one or many Parameter Store values
+## Install
+With npm:
+```bash
+npm install @vyriy/services
+```
+With Yarn:
+```bash
+yarn add @vyriy/services
+```
+## LocalStack
+Some clients are prepared for local AWS-compatible development:
+- `dynamodb` uses `LOCALSTACK_HOST` and `LOCALSTACK_PORT` as its endpoint when
+  `@vyriy/env` reports the local stage.
+- `s3` uses the same LocalStack endpoint in local stage and enables
+  `forcePathStyle`.
+- `ecs` uses the configured region in local stage, but does not point to a
+  LocalStack endpoint.
+- `cloudfront`, `lambda`, `sns`, and `ssm` currently use their normal AWS SDK
+  client configuration.
+LocalStack defaults come from `@vyriy/env`:
+- `LOCALSTACK_HOST`: defaults to `localhost`
+- `LOCALSTACK_PORT`: defaults to `4566`
+## Usage
+Import from the package root:
+```ts
+import * as services from '@vyriy/services';
+await services.s3.upload('assets-bucket', 'pages/index.html', '<html>...</html>', 'text/html');
+await services.lambda.invoke('my-function', JSON.stringify({ ok: true }));
+```
+Or import a service subpath directly:
+```ts
+import { getParameter } from '@vyriy/services/ssm';
+import { upload } from '@vyriy/services/s3';
+const apiUrl = await getParameter('/app/api-url');
+await upload('assets-bucket', 'config/api-url.txt', apiUrl, 'text/plain');
+```
+## Examples
+Invalidate CloudFront after publishing static files:
+```ts
+import { invalidate } from '@vyriy/services/cloudfront';
+await invalidate('DISTRIBUTION_ID', ['/index.html', '/assets/*'], true);
+```
+Run a Fargate task:
+```ts
+import { runTask } from '@vyriy/services/ecs';
+await runTask('regenerate-pages', [{ name: 'CONTENT_ID', value: 'home' }]);
+```
+Read application settings from SSM:
+```ts
+import { getParameters } from '@vyriy/services/ssm';
+const settings = await getParameters(['/app/api-url', '/app/cdn-url']);
+```

package/cloudfront/actions.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { Invalidate } from './types.js';
2	+ export declare const invalidate: Invalidate;

package/cloudfront/actions.js ADDED Viewed

@@ -0,0 +1,40 @@
+import { CreateInvalidationCommand, GetInvalidationCommand } from '@aws-sdk/client-cloudfront';
+import { createLogger } from '@vyriy/logger';
+import { pause } from '@vyriy/pause';
+import { toError } from '@vyriy/error';
+import { client } from './client.js';
+export const invalidate = async (distribution, paths, shouldWait = false) => {
+    try {
+        const logger = createLogger();
+        logger.info('Distribution:', distribution);
+        logger.info('Paths:', paths);
+        logger.info('CreateInvalidationCommand');
+        const invalidationResponse = await client.send(new CreateInvalidationCommand({
+            DistributionId: distribution,
+            InvalidationBatch: {
+                CallerReference: Date.now().toString(),
+                Paths: {
+                    Quantity: paths.length,
+                    Items: paths,
+                },
+            },
+        }));
+        const check = async () => {
+            const response = await client.send(new GetInvalidationCommand({
+                DistributionId: distribution,
+                Id: invalidationResponse.Invalidation?.Id,
+            }));
+            if (response.Invalidation?.Status !== 'Completed') {
+                await pause(3000);
+                await check();
+            }
+        };
+        if (shouldWait) {
+            await check();
+        }
+    }
+    catch (e) {
+        createLogger().error(e);
+        throw toError(e);
+    }
+};

package/cloudfront/client.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { CloudFrontClient } from '@aws-sdk/client-cloudfront';
2	+ export declare const client: CloudFrontClient;

package/cloudfront/client.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { CloudFrontClient } from '@aws-sdk/client-cloudfront';
2	+ export const client = new CloudFrontClient({});

package/cloudfront/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export * from './actions.js';
+export * from './client.js';
+export type * from './types.js';

package/cloudfront/index.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from './actions.js';
2	+ export * from './client.js';

package/cloudfront/types.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export type Invalidate = (distribution: string, paths: string[], shouldWait?: boolean) => Promise<void>;

package/dynamodb/actions.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import type { CreateItem, CreateTable, DeleteItem, GetAllItems, GetAllItemsWithHandler, GetItem, GetItems, UpdateItem } from './types.js';
+export declare const createTable: CreateTable;
+export declare const createItem: CreateItem;
+export declare const updateItem: UpdateItem;
+export declare const getItem: GetItem;
+export declare const deleteItem: DeleteItem;
+export declare const getItems: GetItems;
+export declare const getAllItems: GetAllItems;
+export declare const getAllItemsWithHandler: GetAllItemsWithHandler;

package/dynamodb/actions.js ADDED Viewed

@@ -0,0 +1,131 @@
+import { CreateTableCommand } from '@aws-sdk/client-dynamodb';
+import { DeleteCommand, GetCommand, PutCommand, QueryCommand, ScanCommand, UpdateCommand } from '@aws-sdk/lib-dynamodb';
+import { createLogger } from '@vyriy/logger';
+import { toError } from '@vyriy/error';
+import { client } from './client.js';
+export const createTable = async (params) => {
+    try {
+        createLogger().log('CreateTableCommand:', params);
+        await client.send(new CreateTableCommand(params));
+    }
+    catch (e) {
+        throw toError(e);
+    }
+};
+export const createItem = async (TableName, Item, options = {}) => {
+    try {
+        createLogger().log('PutCommand:', { TableName, Item, ...options });
+        await client.send(new PutCommand({ TableName, Item, ...options }));
+    }
+    catch (e) {
+        throw toError(e);
+    }
+};
+export const updateItem = async (TableName, Key, UpdateExpression, ExpressionAttributeValues, options = {}) => {
+    try {
+        const logger = createLogger();
+        const params = {
+            TableName,
+            Key,
+            UpdateExpression,
+            ExpressionAttributeValues,
+            ...options,
+        };
+        logger.log('UpdateCommand:', params);
+        await client.send(new UpdateCommand(params));
+    }
+    catch (e) {
+        throw toError(e);
+    }
+};
+export const getItem = async (TableName, Key, options = {}) => {
+    try {
+        createLogger().log('GetCommand:', { TableName, Key, ...options });
+        return await client.send(new GetCommand({ TableName, Key, ...options })).then(({ Item }) => Item);
+    }
+    catch (e) {
+        throw toError(e);
+    }
+};
+export const deleteItem = async (TableName, Key, options = {}) => {
+    try {
+        createLogger().log('DeleteCommand:', { TableName, Key, ...options });
+        await client.send(new DeleteCommand({ TableName, Key, ...options }));
+    }
+    catch (e) {
+        throw toError(e);
+    }
+};
+export const getItems = async (TableName, keys, options = {}) => {
+    try {
+        const logger = createLogger();
+        const expressionList = [];
+        const ExpressionAttributeNames = {};
+        const ExpressionAttributeValues = {};
+        Object.keys(keys).forEach((key) => {
+            if (keys[key] !== undefined && keys[key] !== '') {
+                ExpressionAttributeNames[`#${key}`] = key;
+                ExpressionAttributeValues[`:${key}`] = keys[key];
+                expressionList.push(`#${key} = :${key}`);
+            }
+        });
+        const queryOptions = {
+            ExpressionAttributeNames,
+            ExpressionAttributeValues,
+            KeyConditionExpression: expressionList.join(' AND '),
+        };
+        const params = { TableName, ...queryOptions, ...options };
+        const items = [];
+        const queryUntilDone = async (ExclusiveStartKey) => {
+            logger.log('QueryCommand:', { ...params, ExclusiveStartKey });
+            const data = await client.send(new QueryCommand({ ...params, ExclusiveStartKey }));
+            items.push(...(data.Items || []));
+            if (data.LastEvaluatedKey) {
+                await queryUntilDone(data.LastEvaluatedKey);
+            }
+        };
+        await queryUntilDone();
+        return items;
+    }
+    catch (e) {
+        throw toError(e);
+    }
+};
+export const getAllItems = async (TableName, options = {}) => {
+    try {
+        const logger = createLogger();
+        const params = { TableName, ...options };
+        const items = [];
+        const scanUntilDone = async (ExclusiveStartKey) => {
+            logger.log('ScanCommand:', { ...params, ExclusiveStartKey });
+            const data = await client.send(new ScanCommand({ ...params, ExclusiveStartKey }));
+            items.push(...(data.Items || []));
+            if (data.LastEvaluatedKey) {
+                await scanUntilDone(data.LastEvaluatedKey);
+            }
+        };
+        await scanUntilDone();
+        return items;
+    }
+    catch (e) {
+        throw toError(e);
+    }
+};
+export const getAllItemsWithHandler = async (TableName, handler, options = {}) => {
+    try {
+        const logger = createLogger();
+        const params = { TableName, ...options };
+        const scanUntilDone = async (ExclusiveStartKey) => {
+            logger.log('ScanCommand:', { ...params, ExclusiveStartKey });
+            const data = await client.send(new ScanCommand({ ...params, ExclusiveStartKey }));
+            await handler(data.Items || []);
+            if (data.LastEvaluatedKey) {
+                await scanUntilDone(data.LastEvaluatedKey);
+            }
+        };
+        await scanUntilDone();
+    }
+    catch (e) {
+        throw toError(e);
+    }
+};

package/dynamodb/client.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
2	+ export declare const client: DynamoDBClient;

package/dynamodb/client.js ADDED Viewed

@@ -0,0 +1,9 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { getLocalstackHost, getLocalstackPort, getRegion, isLocal } from '@vyriy/env';
+const options = isLocal()
+    ? {
+        region: getRegion(),
+        endpoint: `http://${getLocalstackHost()}:${getLocalstackPort()}`,
+    }
+    : {};
+export const client = new DynamoDBClient(options);

package/dynamodb/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export * from './actions.js';
+export * from './client.js';
+export type * from './types.js';

package/dynamodb/index.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from './actions.js';
2	+ export * from './client.js';

package/dynamodb/types.d.ts ADDED Viewed

@@ -0,0 +1,14 @@
+import type { CreateTableCommandInput } from '@aws-sdk/client-dynamodb';
+import type { NativeAttributeValue } from '@aws-sdk/util-dynamodb';
+import type { DeleteCommandInput, GetCommandInput, PutCommandInput, QueryCommandInput, ScanCommandInput, UpdateCommandInput } from '@aws-sdk/lib-dynamodb';
+export type CreateTable = (params: CreateTableCommandInput) => Promise<void>;
+export type Key = Record<string, NativeAttributeValue>;
+export type Item = Record<string, unknown>;
+export type CreateItem = (TableName: string, Item: Item, options?: Omit<PutCommandInput, 'TableName' | 'Item'>) => Promise<void>;
+export type GetItem = (TableName: string, Key: Record<string, string | number>, options?: Omit<GetCommandInput, 'TableName' | 'Key'>) => Promise<Item | undefined>;
+export type DeleteItem = (TableName: string, Key: Record<string, string | number>, options?: Omit<DeleteCommandInput, 'TableName' | 'Key'>) => Promise<void>;
+export type UpdateItem = (TableName: string, Key: Record<string, string | number>, UpdateExpression: string, ExpressionAttributeValues?: Record<string, unknown>, options?: Omit<UpdateCommandInput, 'TableName' | 'Key' | 'UpdateExpression' | 'ExpressionAttributeValues'>) => Promise<void>;
+export type GetItems = (TableName: string, keys: Record<string, unknown>, options?: Omit<QueryCommandInput, 'TableName'>) => Promise<unknown[]>;
+export type GetAllItems = (TableName: string, options?: Omit<ScanCommandInput, 'TableName'>) => Promise<unknown[]>;
+export type Handler = (items: unknown[]) => Promise<void>;
+export type GetAllItemsWithHandler = (TableName: string, handler: Handler, options?: Omit<ScanCommandInput, 'TableName'>) => Promise<void>;

package/ecs/actions.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { RunTask } from './types.js';
2	+ export declare const runTask: RunTask;

package/ecs/actions.js ADDED Viewed

@@ -0,0 +1,50 @@
+import { RunTaskCommand } from '@aws-sdk/client-ecs';
+import { getEcsClusterName, getEcsTaskDefinition, getVpcSecurityGroup, getVpcSubnets } from '@vyriy/env';
+import { createLogger } from '@vyriy/logger';
+import { client } from './client.js';
+export const runTask = async (task, environment = [], taskDefinition = getEcsTaskDefinition()) => {
+    const cluster = getEcsClusterName();
+    const subnets = getVpcSubnets();
+    const securityGroup = getVpcSecurityGroup();
+    if (!cluster) {
+        throw new Error('Cluster must be set!');
+    }
+    if (!taskDefinition) {
+        throw new Error('Task definition must be set!');
+    }
+    if (!subnets) {
+        throw new Error('Subnets must be set!');
+    }
+    if (!securityGroup) {
+        throw new Error('SecurityGroup must be set!');
+    }
+    const params = {
+        cluster,
+        taskDefinition,
+        launchType: 'FARGATE',
+        count: 1,
+        networkConfiguration: {
+            awsvpcConfiguration: {
+                assignPublicIp: 'ENABLED',
+                subnets: subnets.split(','),
+                securityGroups: [securityGroup],
+            },
+        },
+        overrides: {
+            containerOverrides: [
+                {
+                    name: task,
+                    environment: [
+                        {
+                            name: 'TASK',
+                            value: task,
+                        },
+                        ...environment,
+                    ],
+                },
+            ],
+        },
+    };
+    createLogger().info('Params:', params);
+    await client.send(new RunTaskCommand(params));
+};

package/ecs/client.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { ECSClient } from '@aws-sdk/client-ecs';
2	+ export declare const client: ECSClient;

package/ecs/client.js ADDED Viewed

@@ -0,0 +1,4 @@
+import { ECSClient } from '@aws-sdk/client-ecs';
+import { getRegion, isLocal } from '@vyriy/env';
+const options = isLocal() ? { region: getRegion() } : {};
+export const client = new ECSClient(options);

package/ecs/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export * from './actions.js';
+export * from './client.js';
+export type * from './types.js';

package/ecs/index.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from './actions.js';
2	+ export * from './client.js';

package/ecs/types.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export type RunTask = (task: string, environment?: {
+    name: string;
+    value: string;
+}[], taskDefinition?: string) => Promise<void>;

package/index.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+export * as cloudfront from './cloudfront/index.js';
+export * as dynamodb from './dynamodb/index.js';
+export * as ecs from './ecs/index.js';
+export * as lambda from './lambda/index.js';
+export * as s3 from './s3/index.js';
+export * as sns from './sns/index.js';
+export * as ssm from './ssm/index.js';

package/index.js ADDED Viewed

@@ -0,0 +1,7 @@
+export * as cloudfront from './cloudfront/index.js';
+export * as dynamodb from './dynamodb/index.js';
+export * as ecs from './ecs/index.js';
+export * as lambda from './lambda/index.js';
+export * as s3 from './s3/index.js';
+export * as sns from './sns/index.js';
+export * as ssm from './ssm/index.js';

package/lambda/actions.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { Invoke } from './types.js';
2	+ export declare const invoke: Invoke;

package/lambda/actions.js ADDED Viewed

@@ -0,0 +1,23 @@
+import { InvokeCommand } from '@aws-sdk/client-lambda';
+import { createLogger } from '@vyriy/logger';
+import { client } from './client.js';
+export const invoke = async (functionName, payload, options = {}) => {
+    const logger = createLogger();
+    logger.info('functionName:', functionName);
+    logger.info('payload:', payload);
+    logger.info('options:', options);
+    const input = {
+        FunctionName: functionName,
+        Payload: new TextEncoder().encode(payload),
+        ...options,
+    };
+    try {
+        const result = await client.send(new InvokeCommand(input));
+        logger.info('Result:', result);
+        return result;
+    }
+    catch (e) {
+        logger.error(e);
+        throw e;
+    }
+};

package/lambda/client.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { LambdaClient } from '@aws-sdk/client-lambda';
2	+ export declare const client: LambdaClient;

package/lambda/client.js ADDED Viewed

@@ -0,0 +1,4 @@
+import { LambdaClient } from '@aws-sdk/client-lambda';
+import { getRegion } from '@vyriy/env';
+const options = { region: getRegion() };
+export const client = new LambdaClient(options);

package/lambda/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export * from './actions.js';
+export * from './client.js';
+export type * from './types.js';

package/lambda/index.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from './actions.js';
2	+ export * from './client.js';

package/lambda/types.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { InvokeCommandInput, InvokeCommandOutput } from '@aws-sdk/client-lambda';
2	+ export type Invoke = (functionName: string, payload: string, options?: Omit<InvokeCommandInput, 'FunctionName' \| 'Payload'>) => Promise<InvokeCommandOutput>;

package/package.json ADDED Viewed

@@ -0,0 +1,251 @@
+{
+  "name": "@vyriy/services",
+  "version": "0.1.9",
+  "description": "Shared services package for Vyriy projects",
+  "type": "module",
+  "main": "./index.js",
+  "dependencies": {
+    "@aws-sdk/client-cloudfront": "^3.1045.0",
+    "@aws-sdk/client-dynamodb": "^3.1045.0",
+    "@aws-sdk/client-ecs": "^3.1045.0",
+    "@aws-sdk/client-lambda": "^3.1045.0",
+    "@aws-sdk/client-s3": "^3.1045.0",
+    "@aws-sdk/client-sns": "^3.1045.0",
+    "@aws-sdk/client-ssm": "^3.1045.0",
+    "@aws-sdk/lib-dynamodb": "^3.1045.0",
+    "@aws-sdk/util-dynamodb": "^3.996.2",
+    "@vyriy/env": "0.1.9",
+    "@vyriy/error": "0.1.9",
+    "@vyriy/logger": "0.1.9",
+    "@vyriy/pause": "0.1.9"
+  },
+  "license": "MIT",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    },
+    "./cloudfront/actions": {
+      "types": "./cloudfront/actions.d.ts",
+      "import": "./cloudfront/actions.js",
+      "default": "./cloudfront/actions.js"
+    },
+    "./cloudfront/actions.js": {
+      "types": "./cloudfront/actions.d.ts",
+      "import": "./cloudfront/actions.js",
+      "default": "./cloudfront/actions.js"
+    },
+    "./cloudfront/client": {
+      "types": "./cloudfront/client.d.ts",
+      "import": "./cloudfront/client.js",
+      "default": "./cloudfront/client.js"
+    },
+    "./cloudfront/client.js": {
+      "types": "./cloudfront/client.d.ts",
+      "import": "./cloudfront/client.js",
+      "default": "./cloudfront/client.js"
+    },
+    "./cloudfront/index": {
+      "types": "./cloudfront/index.d.ts",
+      "import": "./cloudfront/index.js",
+      "default": "./cloudfront/index.js"
+    },
+    "./cloudfront/index.js": {
+      "types": "./cloudfront/index.d.ts",
+      "import": "./cloudfront/index.js",
+      "default": "./cloudfront/index.js"
+    },
+    "./dynamodb/actions": {
+      "types": "./dynamodb/actions.d.ts",
+      "import": "./dynamodb/actions.js",
+      "default": "./dynamodb/actions.js"
+    },
+    "./dynamodb/actions.js": {
+      "types": "./dynamodb/actions.d.ts",
+      "import": "./dynamodb/actions.js",
+      "default": "./dynamodb/actions.js"
+    },
+    "./dynamodb/client": {
+      "types": "./dynamodb/client.d.ts",
+      "import": "./dynamodb/client.js",
+      "default": "./dynamodb/client.js"
+    },
+    "./dynamodb/client.js": {
+      "types": "./dynamodb/client.d.ts",
+      "import": "./dynamodb/client.js",
+      "default": "./dynamodb/client.js"
+    },
+    "./dynamodb/index": {
+      "types": "./dynamodb/index.d.ts",
+      "import": "./dynamodb/index.js",
+      "default": "./dynamodb/index.js"
+    },
+    "./dynamodb/index.js": {
+      "types": "./dynamodb/index.d.ts",
+      "import": "./dynamodb/index.js",
+      "default": "./dynamodb/index.js"
+    },
+    "./ecs/actions": {
+      "types": "./ecs/actions.d.ts",
+      "import": "./ecs/actions.js",
+      "default": "./ecs/actions.js"
+    },
+    "./ecs/actions.js": {
+      "types": "./ecs/actions.d.ts",
+      "import": "./ecs/actions.js",
+      "default": "./ecs/actions.js"
+    },
+    "./ecs/client": {
+      "types": "./ecs/client.d.ts",
+      "import": "./ecs/client.js",
+      "default": "./ecs/client.js"
+    },
+    "./ecs/client.js": {
+      "types": "./ecs/client.d.ts",
+      "import": "./ecs/client.js",
+      "default": "./ecs/client.js"
+    },
+    "./ecs/index": {
+      "types": "./ecs/index.d.ts",
+      "import": "./ecs/index.js",
+      "default": "./ecs/index.js"
+    },
+    "./ecs/index.js": {
+      "types": "./ecs/index.d.ts",
+      "import": "./ecs/index.js",
+      "default": "./ecs/index.js"
+    },
+    "./index": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    },
+    "./index.js": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    },
+    "./lambda/actions": {
+      "types": "./lambda/actions.d.ts",
+      "import": "./lambda/actions.js",
+      "default": "./lambda/actions.js"
+    },
+    "./lambda/actions.js": {
+      "types": "./lambda/actions.d.ts",
+      "import": "./lambda/actions.js",
+      "default": "./lambda/actions.js"
+    },
+    "./lambda/client": {
+      "types": "./lambda/client.d.ts",
+      "import": "./lambda/client.js",
+      "default": "./lambda/client.js"
+    },
+    "./lambda/client.js": {
+      "types": "./lambda/client.d.ts",
+      "import": "./lambda/client.js",
+      "default": "./lambda/client.js"
+    },
+    "./lambda/index": {
+      "types": "./lambda/index.d.ts",
+      "import": "./lambda/index.js",
+      "default": "./lambda/index.js"
+    },
+    "./lambda/index.js": {
+      "types": "./lambda/index.d.ts",
+      "import": "./lambda/index.js",
+      "default": "./lambda/index.js"
+    },
+    "./s3/actions": {
+      "types": "./s3/actions.d.ts",
+      "import": "./s3/actions.js",
+      "default": "./s3/actions.js"
+    },
+    "./s3/actions.js": {
+      "types": "./s3/actions.d.ts",
+      "import": "./s3/actions.js",
+      "default": "./s3/actions.js"
+    },
+    "./s3/client": {
+      "types": "./s3/client.d.ts",
+      "import": "./s3/client.js",
+      "default": "./s3/client.js"
+    },
+    "./s3/client.js": {
+      "types": "./s3/client.d.ts",
+      "import": "./s3/client.js",
+      "default": "./s3/client.js"
+    },
+    "./s3/index": {
+      "types": "./s3/index.d.ts",
+      "import": "./s3/index.js",
+      "default": "./s3/index.js"
+    },
+    "./s3/index.js": {
+      "types": "./s3/index.d.ts",
+      "import": "./s3/index.js",
+      "default": "./s3/index.js"
+    },
+    "./sns/actions": {
+      "types": "./sns/actions.d.ts",
+      "import": "./sns/actions.js",
+      "default": "./sns/actions.js"
+    },
+    "./sns/actions.js": {
+      "types": "./sns/actions.d.ts",
+      "import": "./sns/actions.js",
+      "default": "./sns/actions.js"
+    },
+    "./sns/client": {
+      "types": "./sns/client.d.ts",
+      "import": "./sns/client.js",
+      "default": "./sns/client.js"
+    },
+    "./sns/client.js": {
+      "types": "./sns/client.d.ts",
+      "import": "./sns/client.js",
+      "default": "./sns/client.js"
+    },
+    "./sns/index": {
+      "types": "./sns/index.d.ts",
+      "import": "./sns/index.js",
+      "default": "./sns/index.js"
+    },
+    "./sns/index.js": {
+      "types": "./sns/index.d.ts",
+      "import": "./sns/index.js",
+      "default": "./sns/index.js"
+    },
+    "./ssm/actions": {
+      "types": "./ssm/actions.d.ts",
+      "import": "./ssm/actions.js",
+      "default": "./ssm/actions.js"
+    },
+    "./ssm/actions.js": {
+      "types": "./ssm/actions.d.ts",
+      "import": "./ssm/actions.js",
+      "default": "./ssm/actions.js"
+    },
+    "./ssm/client": {
+      "types": "./ssm/client.d.ts",
+      "import": "./ssm/client.js",
+      "default": "./ssm/client.js"
+    },
+    "./ssm/client.js": {
+      "types": "./ssm/client.d.ts",
+      "import": "./ssm/client.js",
+      "default": "./ssm/client.js"
+    },
+    "./ssm/index": {
+      "types": "./ssm/index.d.ts",
+      "import": "./ssm/index.js",
+      "default": "./ssm/index.js"
+    },
+    "./ssm/index.js": {
+      "types": "./ssm/index.d.ts",
+      "import": "./ssm/index.js",
+      "default": "./ssm/index.js"
+    }
+  }
+}

package/s3/actions.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import type { Download, Exists, Upload } from './types.js';
+export declare const download: Download;
+export declare const upload: Upload;
+export declare const exists: Exists;

package/s3/actions.js ADDED Viewed

@@ -0,0 +1,59 @@
+import { GetObjectCommand, HeadObjectCommand, PutObjectCommand } from '@aws-sdk/client-s3';
+import { createLogger } from '@vyriy/logger';
+import { toError } from '@vyriy/error';
+import { client } from './client.js';
+export const download = async (bucketName, path, options = {}) => {
+    try {
+        const logger = createLogger();
+        logger.log('GetObjectCommand:', { Bucket: bucketName, Key: path, ...options });
+        const response = await client.send(new GetObjectCommand({ Bucket: bucketName, Key: path, ...options }));
+        const str = await response.Body?.transformToString();
+        logger.log(str);
+        return str;
+    }
+    catch (e) {
+        createLogger().error(e);
+        throw toError(e);
+    }
+};
+export const upload = async (bucketName, path, body, mimeType = 'application/json;charset=utf-8', options = {}) => {
+    try {
+        createLogger().log('PutObjectCommand:', {
+            Bucket: bucketName,
+            Key: path,
+            Body: body,
+            ContentType: mimeType,
+            ...options,
+        });
+        await client.send(new PutObjectCommand({
+            Bucket: bucketName,
+            Key: path,
+            Body: body,
+            ContentType: mimeType,
+            ...options,
+        }));
+    }
+    catch (e) {
+        createLogger().error(e);
+        throw toError(e);
+    }
+};
+export const exists = async (bucketName, path, options = {}) => {
+    try {
+        createLogger().log('HeadObjectCommand:', {
+            Bucket: bucketName,
+            Key: path,
+            ...options,
+        });
+        const output = await client.send(new HeadObjectCommand({
+            Bucket: bucketName,
+            Key: path,
+            ...options,
+        }));
+        return output.$metadata.httpStatusCode === 200;
+    }
+    catch (e) {
+        createLogger().error(e);
+        throw toError(e);
+    }
+};

package/s3/client.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { S3Client } from '@aws-sdk/client-s3';
2	+ export declare const client: S3Client;

package/s3/client.js ADDED Viewed

@@ -0,0 +1,10 @@
+import { S3Client } from '@aws-sdk/client-s3';
+import { getRegion, getLocalstackHost, getLocalstackPort, isLocal } from '@vyriy/env';
+const options = isLocal()
+    ? {
+        region: getRegion(),
+        endpoint: `http://${getLocalstackHost()}:${getLocalstackPort()}`,
+        forcePathStyle: true,
+    }
+    : {};
+export const client = new S3Client(options);

package/s3/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export * from './actions.js';
+export * from './client.js';
+export type * from './types.js';

package/s3/index.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from './actions.js';
2	+ export * from './client.js';

package/s3/types.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import type { GetObjectCommandInput, HeadObjectCommandInput, PutObjectCommandInput } from '@aws-sdk/client-s3';
+export type Download = (bucketName: string, path: string, options?: Omit<GetObjectCommandInput, 'Bucket' | 'Key'>) => Promise<string | undefined>;
+export type Upload = (bucketName: string, path: string, body: string | Buffer, mimeType?: string, options?: Omit<PutObjectCommandInput, 'Bucket' | 'Key' | 'Body' | 'ContentType'>) => Promise<void>;
+export type Exists = (bucketName: string, path: string, options?: Omit<HeadObjectCommandInput, 'Bucket' | 'Key' | 'Body' | 'ContentType'>) => Promise<boolean>;

package/sns/actions.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { Publish } from './types.js';
2	+ export declare const publish: Publish;

package/sns/actions.js ADDED Viewed

@@ -0,0 +1,8 @@
+import { client } from './client.js';
+export const publish = async (topicArn, message, options = {}) => {
+    await client.publish({
+        TopicArn: topicArn,
+        Message: message,
+        ...options,
+    });
+};

package/sns/client.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { SNS } from '@aws-sdk/client-sns';
2	+ export declare const client: SNS;

package/sns/client.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { SNS } from '@aws-sdk/client-sns';
2	+ export const client = new SNS({});

package/sns/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export * from './actions.js';
+export * from './client.js';
+export type * from './types.js';

package/sns/index.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from './actions.js';
2	+ export * from './client.js';

package/sns/types.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { PublishCommandInput } from '@aws-sdk/client-sns';
2	+ export type Publish = (topicArn: string, message: string, options?: Omit<PublishCommandInput, 'TopicArn' \| 'Message'>) => Promise<void>;

package/ssm/actions.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+import type { GetParameter, GetParameters } from './types.js';
+export declare const getParameter: GetParameter;
+export declare const getParameters: GetParameters;

package/ssm/actions.js ADDED Viewed

@@ -0,0 +1,37 @@
+import { GetParameterCommand, GetParametersCommand } from '@aws-sdk/client-ssm';
+import { createLogger } from '@vyriy/logger';
+import { toError } from '@vyriy/error';
+import { client } from './client.js';
+export const getParameter = async (parameterName, decrypted = true) => {
+    try {
+        const logger = createLogger();
+        logger.log('GetParameterCommand:', parameterName, decrypted);
+        const response = await client.send(new GetParameterCommand({ Name: parameterName, WithDecryption: decrypted }));
+        const parameter = response.Parameter?.Value || '';
+        logger.log(parameter);
+        return parameter;
+    }
+    catch (e) {
+        createLogger().error(e);
+        throw toError(e);
+    }
+};
+export const getParameters = async (parameterNames, decrypted = true) => {
+    try {
+        const logger = createLogger();
+        logger.log('GetParametersCommand:', parameterNames, decrypted);
+        const response = await client.send(new GetParametersCommand({ Names: parameterNames, WithDecryption: decrypted }));
+        const parameters = response.Parameters?.reduce((result, { Name, Value }) => {
+            if (Name && Value !== undefined) {
+                result[Name] = Value;
+            }
+            return result;
+        }, {}) ?? {};
+        logger.log(parameters);
+        return parameters;
+    }
+    catch (e) {
+        createLogger().error(e);
+        throw toError(e);
+    }
+};

package/ssm/client.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { SSMClient } from '@aws-sdk/client-ssm';
2	+ export declare const client: SSMClient;

package/ssm/client.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { SSMClient } from '@aws-sdk/client-ssm';
2	+ export const client = new SSMClient({});

package/ssm/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export * from './actions.js';
+export * from './client.js';
+export type * from './types.js';

package/ssm/index.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from './actions.js';
2	+ export * from './client.js';

package/ssm/types.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export type GetParameter = (parameterName: string, decrypted?: boolean) => Promise<string>;
2	+ export type GetParameters = (parameterNames: string[], decrypted?: boolean) => Promise<Record<string, string>>;