@augustdigital/config 0.1.0

package/lib/schemas/vault.d.ts

@@ -0,0 +1,265 @@
+import { z } from 'zod';
+export declare const VaultGetSchema: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    name: z.ZodOptional<z.ZodString>;
+    symbol: z.ZodOptional<z.ZodString>;
+    decimals: z.ZodOptional<z.ZodNumber>;
+    underlying: z.ZodOptional<z.ZodObject<{
+        address: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        decimals: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        address: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        decimals: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        address: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        decimals: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    name: z.ZodOptional<z.ZodString>;
+    symbol: z.ZodOptional<z.ZodString>;
+    decimals: z.ZodOptional<z.ZodNumber>;
+    underlying: z.ZodOptional<z.ZodObject<{
+        address: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        decimals: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        address: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        decimals: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        address: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        decimals: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    name: z.ZodOptional<z.ZodString>;
+    symbol: z.ZodOptional<z.ZodString>;
+    decimals: z.ZodOptional<z.ZodNumber>;
+    underlying: z.ZodOptional<z.ZodObject<{
+        address: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        decimals: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        address: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        decimals: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        address: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        decimals: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type VaultGet = z.infer<typeof VaultGetSchema>;
+export declare const VaultApySchema: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    currentApy: z.ZodOptional<z.ZodNumber>;
+    annualizedApy: z.ZodOptional<z.ZodNumber>;
+    asOf: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    currentApy: z.ZodOptional<z.ZodNumber>;
+    annualizedApy: z.ZodOptional<z.ZodNumber>;
+    asOf: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    currentApy: z.ZodOptional<z.ZodNumber>;
+    annualizedApy: z.ZodOptional<z.ZodNumber>;
+    asOf: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type VaultApy = z.infer<typeof VaultApySchema>;
+export declare const VaultTvlSchema: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    tvl: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    underlyingSymbol: z.ZodOptional<z.ZodString>;
+    asOf: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    tvl: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    underlyingSymbol: z.ZodOptional<z.ZodString>;
+    asOf: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    tvl: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    underlyingSymbol: z.ZodOptional<z.ZodString>;
+    asOf: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type VaultTvl = z.infer<typeof VaultTvlSchema>;
+export declare const VaultPositionsSchema: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    user: z.ZodOptional<z.ZodString>;
+    positions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        user: z.ZodString;
+        shares: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        assets: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        user: z.ZodString;
+        shares: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        assets: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        user: z.ZodString;
+        shares: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        assets: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    user: z.ZodOptional<z.ZodString>;
+    positions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        user: z.ZodString;
+        shares: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        assets: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        user: z.ZodString;
+        shares: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        assets: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        user: z.ZodString;
+        shares: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        assets: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    user: z.ZodOptional<z.ZodString>;
+    positions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        user: z.ZodString;
+        shares: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        assets: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        user: z.ZodString;
+        shares: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        assets: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        user: z.ZodString;
+        shares: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        assets: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type VaultPositions = z.infer<typeof VaultPositionsSchema>;
+export declare const VaultLoansSchema: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    loans: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    loans: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    loans: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type VaultLoans = z.infer<typeof VaultLoansSchema>;
+export declare const VaultAllocationsSchema: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    allocations: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    allocations: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    allocations: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type VaultAllocations = z.infer<typeof VaultAllocationsSchema>;
+export declare const VaultRedemptionsSchema: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    user: z.ZodOptional<z.ZodString>;
+    available: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+    history: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    user: z.ZodOptional<z.ZodString>;
+    available: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+    history: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    user: z.ZodOptional<z.ZodString>;
+    available: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+    history: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type VaultRedemptions = z.infer<typeof VaultRedemptionsSchema>;
+export declare const VaultHistorySchema: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    series: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    series: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    series: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type VaultHistory = z.infer<typeof VaultHistorySchema>;
+export declare const VaultSummarySchema: z.ZodObject<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    address: z.ZodString;
+    chainId: z.ZodNumber;
+}, z.ZodTypeAny, "passthrough">>;
+export type VaultSummary = z.infer<typeof VaultSummarySchema>;
+export declare const VaultListSchema: z.ZodObject<{
+    vaults: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        symbol: z.ZodString;
+        address: z.ZodString;
+        chainId: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        symbol?: string;
+        name?: string;
+        chainId?: number;
+        address?: string;
+    }, {
+        symbol?: string;
+        name?: string;
+        chainId?: number;
+        address?: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    vaults?: {
+        symbol?: string;
+        name?: string;
+        chainId?: number;
+        address?: string;
+    }[];
+}, {
+    vaults?: {
+        symbol?: string;
+        name?: string;
+        chainId?: number;
+        address?: string;
+    }[];
+}>;
+export type VaultList = z.infer<typeof VaultListSchema>;

package/lib/schemas/vault.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VaultListSchema = exports.VaultSummarySchema = exports.VaultHistorySchema = exports.VaultRedemptionsSchema = exports.VaultAllocationsSchema = exports.VaultLoansSchema = exports.VaultPositionsSchema = exports.VaultTvlSchema = exports.VaultApySchema = exports.VaultGetSchema = void 0;
+const zod_1 = require("zod");
+const Address = zod_1.z
+    .string()
+    .regex(/^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$/, {
+    message: 'Expected an EVM (0x…) or Solana address.',
+});
+const BigNumeric = zod_1.z.union([zod_1.z.string(), zod_1.z.number()]);
+exports.VaultGetSchema = zod_1.z
+    .object({
+    address: Address,
+    chainId: zod_1.z.number().int(),
+    name: zod_1.z.string().optional(),
+    symbol: zod_1.z.string().optional(),
+    decimals: zod_1.z.number().int().nonnegative().optional(),
+    underlying: zod_1.z
+        .object({
+        address: Address,
+        symbol: zod_1.z.string().optional(),
+        decimals: zod_1.z.number().int().nonnegative().optional(),
+    })
+        .partial()
+        .passthrough()
+        .optional(),
+})
+    .passthrough();
+exports.VaultApySchema = zod_1.z
+    .object({
+    address: Address,
+    chainId: zod_1.z.number().int(),
+    currentApy: zod_1.z.number().optional(),
+    annualizedApy: zod_1.z.number().optional(),
+    asOf: zod_1.z.string().datetime().optional(),
+})
+    .passthrough();
+exports.VaultTvlSchema = zod_1.z
+    .object({
+    address: Address,
+    chainId: zod_1.z.number().int(),
+    tvl: BigNumeric,
+    underlyingSymbol: zod_1.z.string().optional(),
+    asOf: zod_1.z.string().datetime().optional(),
+})
+    .passthrough();
+exports.VaultPositionsSchema = zod_1.z
+    .object({
+    address: Address,
+    chainId: zod_1.z.number().int(),
+    user: Address.optional(),
+    positions: zod_1.z
+        .array(zod_1.z
+        .object({
+        user: Address,
+        shares: BigNumeric,
+        assets: BigNumeric.optional(),
+    })
+        .passthrough())
+        .default([]),
+})
+    .passthrough();
+exports.VaultLoansSchema = zod_1.z
+    .object({
+    address: Address,
+    chainId: zod_1.z.number().int(),
+    loans: zod_1.z.array(zod_1.z.unknown()).default([]),
+})
+    .passthrough();
+exports.VaultAllocationsSchema = zod_1.z
+    .object({
+    address: Address,
+    chainId: zod_1.z.number().int(),
+    allocations: zod_1.z.array(zod_1.z.unknown()).default([]),
+})
+    .passthrough();
+exports.VaultRedemptionsSchema = zod_1.z
+    .object({
+    address: Address,
+    chainId: zod_1.z.number().int(),
+    user: Address.optional(),
+    available: zod_1.z.array(zod_1.z.unknown()).default([]),
+    history: zod_1.z.array(zod_1.z.unknown()).default([]),
+})
+    .passthrough();
+exports.VaultHistorySchema = zod_1.z
+    .object({
+    address: Address,
+    chainId: zod_1.z.number().int(),
+    from: zod_1.z.string().datetime().optional(),
+    to: zod_1.z.string().datetime().optional(),
+    series: zod_1.z.array(zod_1.z.unknown()).default([]),
+})
+    .passthrough();
+exports.VaultSummarySchema = zod_1.z
+    .object({
+    address: Address,
+    chainId: zod_1.z.number().int(),
+})
+    .passthrough();
+exports.VaultListSchema = zod_1.z.object({
+    vaults: zod_1.z.array(zod_1.z.object({
+        name: zod_1.z.string(),
+        symbol: zod_1.z.string(),
+        address: Address,
+        chainId: zod_1.z.number().int().optional(),
+    })),
+});
+//# sourceMappingURL=vault.js.map

package/lib/sdk.d.ts

@@ -0,0 +1,14 @@
+import AugustSDK from '@augustdigital/sdk';
+import { Config } from './config';
+export interface CreateSdkOptions {
+    config?: Config;
+    profileName?: string;
+    appName?: string;
+    withoutApiKey?: boolean;
+    cliApiKey?: string;
+    chainId?: number;
+    cliRpcUrl?: string;
+    disableAnalytics?: boolean;
+}
+export declare function createSDK(opts?: CreateSdkOptions): Promise<AugustSDK>;
+export declare function resolvedRpcUrl(chainId: number): string;

package/lib/sdk.js

@@ -0,0 +1,120 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSDK = createSDK;
+exports.resolvedRpcUrl = resolvedRpcUrl;
+const sdk_1 = __importStar(require("@augustdigital/sdk"));
+const config_1 = require("./config");
+const profile_1 = require("./profile");
+const precedence_1 = require("./precedence");
+function buildProviders(config, profileRpcs, chainId, cliRpcUrl) {
+    const merged = {
+        ...config.rpcs,
+        ...(profileRpcs ?? {}),
+    };
+    for (const key of Object.keys(process.env)) {
+        if (key.startsWith('AUGUST_RPC_')) {
+            const tail = key.slice('AUGUST_RPC_'.length);
+            if (/^\d+$/.test(tail)) {
+                const url = process.env[key]?.trim();
+                if (url)
+                    merged[tail] = url;
+            }
+        }
+    }
+    if (chainId !== undefined && cliRpcUrl) {
+        merged[String(chainId)] = cliRpcUrl;
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(merged)) {
+        const n = Number(k);
+        if (Number.isFinite(n))
+            out[n] = v;
+    }
+    if (chainId !== undefined && out[chainId] === undefined) {
+        const [publicFallback] = (0, sdk_1.getFallbackRpcUrls)(chainId);
+        if (publicFallback)
+            out[chainId] = publicFallback;
+    }
+    return out;
+}
+async function createSDK(opts = {}) {
+    const config = opts.config ?? (0, config_1.loadConfig)();
+    const profileName = opts.profileName ?? process.env.AUGUST_PROFILE ?? config.defaultProfile;
+    let profileRpcs;
+    try {
+        profileRpcs = (0, profile_1.loadProfile)(profileName).rpcs;
+    }
+    catch {
+        profileRpcs = undefined;
+    }
+    const providers = buildProviders(config, profileRpcs, opts.chainId, opts.cliRpcUrl);
+    const augustKey = opts.withoutApiKey
+        ? undefined
+        : tryGetApiKey({ cliApiKey: opts.cliApiKey, profileName });
+    const appName = opts.appName ?? config.appName ?? 'august-cli';
+    const disableAnalytics = opts.disableAnalytics !== undefined
+        ? opts.disableAnalytics
+        : !config.telemetry;
+    if (opts.chainId !== undefined && opts.cliRpcUrl) {
+        return new sdk_1.default({
+            appName,
+            providers: { [opts.chainId]: opts.cliRpcUrl, ...providers },
+            keys: augustKey ? { august: augustKey } : {},
+            analytics: { enabled: !disableAnalytics },
+        });
+    }
+    return new sdk_1.default({
+        appName,
+        providers,
+        keys: augustKey ? { august: augustKey } : {},
+        analytics: { enabled: !disableAnalytics },
+    });
+}
+function tryGetApiKey(opts) {
+    try {
+        return (0, precedence_1.getApiKey)({
+            cliApiKey: opts.cliApiKey,
+            profileName: opts.profileName,
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolvedRpcUrl(chainId) {
+    return (0, precedence_1.getRpcUrl)(chainId);
+}
+//# sourceMappingURL=sdk.js.map

package/lib/session.d.ts

@@ -0,0 +1,8 @@
+export interface SessionPayload {
+    apiKey?: string;
+    expiresAt: number;
+}
+export declare function readSession(path?: string): SessionPayload | null;
+export declare function writeSession(payload: Omit<SessionPayload, 'expiresAt'>, ttlSec: number, path?: string): SessionPayload;
+export declare function clearSession(path?: string): void;
+export declare function sessionActive(path?: string): boolean;

package/lib/session.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSession = readSession;
+exports.writeSession = writeSession;
+exports.clearSession = clearSession;
+exports.sessionActive = sessionActive;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const zod_1 = require("zod");
+const errors_1 = require("./errors");
+const paths_1 = require("./paths");
+const SessionFileSchema = zod_1.z.object({
+    schemaVersion: zod_1.z.literal(1),
+    apiKey: zod_1.z.string().min(1).optional(),
+    expiresAt: zod_1.z.number().int().positive(),
+});
+function ensureFileMode(path, mode) {
+    try {
+        (0, node_fs_1.chmodSync)(path, mode);
+    }
+    catch {
+    }
+}
+function readSession(path = (0, paths_1.sessionFile)()) {
+    if (!(0, node_fs_1.existsSync)(path))
+        return null;
+    let raw;
+    try {
+        raw = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch {
+        throw new errors_1.AugustConfigError('SESSION_INVALID', `Session file at ${path} is not valid JSON.`, 'Run `august logout` and then `august login` again.');
+    }
+    const parsed = SessionFileSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw new errors_1.AugustConfigError('SESSION_INVALID', `Session file at ${path} failed validation.`, 'Run `august logout` and then `august login` again.');
+    }
+    if (parsed.data.expiresAt <= Date.now()) {
+        throw new errors_1.AugustConfigError('SESSION_EXPIRED', 'Session has expired.', 'Run `august login` to start a new session.');
+    }
+    return {
+        apiKey: parsed.data.apiKey,
+        expiresAt: parsed.data.expiresAt,
+    };
+}
+function writeSession(payload, ttlSec, path = (0, paths_1.sessionFile)()) {
+    if (!Number.isFinite(ttlSec) || ttlSec <= 0) {
+        throw new errors_1.AugustConfigError('SESSION_INVALID', `Session TTL must be a positive number of seconds (got ${ttlSec}).`);
+    }
+    const expiresAt = Date.now() + ttlSec * 1000;
+    const file = { schemaVersion: 1, ...payload, expiresAt };
+    const dir = (0, node_path_1.dirname)(path);
+    if (!(0, node_fs_1.existsSync)(dir)) {
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true, mode: 0o700 });
+    }
+    (0, node_fs_1.writeFileSync)(path, JSON.stringify(file, null, 2), {
+        encoding: 'utf8',
+        mode: 0o600,
+    });
+    ensureFileMode(path, 0o600);
+    ensureFileMode(dir, 0o700);
+    return { apiKey: payload.apiKey, expiresAt };
+}
+function clearSession(path = (0, paths_1.sessionFile)()) {
+    if ((0, node_fs_1.existsSync)(path))
+        (0, node_fs_1.unlinkSync)(path);
+}
+function sessionActive(path = (0, paths_1.sessionFile)()) {
+    try {
+        return readSession(path) !== null;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=session.js.map

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@augustdigital/config",
+  "version": "0.1.0",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "description": "Shared configuration, keystore, and SDK factory used by @augustdigital/cli and @augustdigital/mcp.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "augustdigital",
+    "sdk",
+    "cli",
+    "mcp",
+    "config"
+  ],
+  "author": "August Digital",
+  "license": "MIT",
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,json}": [
+      "eslint --fix"
+    ],
+    "*.{md,html,yaml}": [
+      "prettier --write"
+    ]
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.d.ts",
+    "lib/**/*.json"
+  ],
+  "dependencies": {
+    "zod": "^3.23.0",
+    "@augustdigital/sdk": "4.27.3"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.14.9",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.9.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf ./lib",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "format": "eslint . --fix",
+    "lint-config": "lint-staged"
+  }
+}