@flipboxlabs/aws-audit-sdk 1.2.3 → 1.4.0

package/dist/constants.d.ts

@@ -79,6 +79,10 @@ export declare const DynamoDB: {
         readonly LSI1_S_SORT_KEY: "LSI1_S_SK";
         /** LSI1 (Numeric) sort key */
         readonly LSI1_N_SORT_KEY: "LSI1_N_SK";
+        /** GSI2 (String-String) partition key - for status-based queries */
+        readonly GSI2_SS_PARTITION_KEY: "GSI2_SS_PK";
+        /** GSI2 (String-String) sort key - for status-based queries */
+        readonly GSI2_SS_SORT_KEY: "GSI2_SS_SK";
     };
     /** Secondary index names */
     readonly Indexes: {
@@ -86,6 +90,8 @@ export declare const DynamoDB: {
         readonly GSI1_SS: "GSI1_SS";
         /** Global Secondary Index 1 - String partition, Numeric sort */
         readonly GSI1_SN: "GSI1_SN";
+        /** Global Secondary Index 2 - String partition, String sort (status-based queries) */
+        readonly GSI2_SS: "GSI2_SS";
         /** Local Secondary Index 1 - String sort key */
         readonly LSI1_S: "LSI1_S";
         /** Local Secondary Index 1 - Numeric sort key */

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C;;GAEG;AACH,KAAK,UAAU,GAAG;IAChB,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IAEZ,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,KAAK,SAAS,GAAG,UAAU,GAAG;IAC5B,yCAAyC;IACzC,GAAG,EAAE;QACH,qCAAqC;QACrC,MAAM,EAAE,MAAM,CAAC;QACf,qBAAqB;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ;IACnB,oCAAoC;;QAElC,6DAA6D;iCAC7C,UAAU;QAC1B,4CAA4C;gCAC7B,SAAS;;IAE1B,mCAAmC;;QAEjC,4BAA4B;;QAE5B,uBAAuB;;QAGvB,yCAAyC;;QAEzC,oCAAoC;;QAGpC,yCAAyC;;QAEzC,oCAAoC;;QAGpC,6BAA6B;;QAE7B,8BAA8B;;;IAGhC,4BAA4B;;QAE1B,+DAA+D;;QAE/D,gEAAgE;;QAGhE,gDAAgD;;QAEhD,iDAAiD;;;IAGnD,8BAA8B;;QAE5B,2DAA2D;;;CAGrD,CAAC;AA0CX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW;IACtB,wCAAwC;;QAEtC,8DAA8D;iCAC9C,UAAU;QAC1B,6CAA6C;gCAC9B,SAAS;;IAE1B,yCAAyC;;IAEzC,wDAAwD;;QAEtD,yDAAyD;;QAEzD,8CAA8C;;;CAGxC,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C;;GAEG;AACH,KAAK,UAAU,GAAG;IAChB,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IAEZ,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,KAAK,SAAS,GAAG,UAAU,GAAG;IAC5B,yCAAyC;IACzC,GAAG,EAAE;QACH,qCAAqC;QACrC,MAAM,EAAE,MAAM,CAAC;QACf,qBAAqB;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ;IACnB,oCAAoC;;QAElC,6DAA6D;iCAC7C,UAAU;QAC1B,4CAA4C;gCAC7B,SAAS;;IAE1B,mCAAmC;;QAEjC,4BAA4B;;QAE5B,uBAAuB;;QAGvB,yCAAyC;;QAEzC,oCAAoC;;QAGpC,yCAAyC;;QAEzC,oCAAoC;;QAGpC,6BAA6B;;QAE7B,8BAA8B;;QAG9B,oEAAoE;;QAEpE,+DAA+D;;;IAGjE,4BAA4B;;QAE1B,+DAA+D;;QAE/D,gEAAgE;;QAGhE,sFAAsF;;QAGtF,gDAAgD;;QAEhD,iDAAiD;;;IAGnD,8BAA8B;;QAE5B,2DAA2D;;;CAGrD,CAAC;AA0CX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW;IACtB,wCAAwC;;QAEtC,8DAA8D;iCAC9C,UAAU;QAC1B,6CAA6C;gCAC9B,SAAS;;IAE1B,yCAAyC;;IAEzC,wDAAwD;;QAEtD,yDAAyD;;QAEzD,8CAA8C;;;CAGxC,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC"}

package/dist/constants.js

@@ -57,6 +57,10 @@ export const DynamoDB = {
         LSI1_S_SORT_KEY: "LSI1_S_SK",
         /** LSI1 (Numeric) sort key */
         LSI1_N_SORT_KEY: "LSI1_N_SK",
+        /** GSI2 (String-String) partition key - for status-based queries */
+        GSI2_SS_PARTITION_KEY: "GSI2_SS_PK",
+        /** GSI2 (String-String) sort key - for status-based queries */
+        GSI2_SS_SORT_KEY: "GSI2_SS_SK",
     },
     /** Secondary index names */
     Indexes: {
@@ -64,6 +68,8 @@ export const DynamoDB = {
         GSI1_SS: "GSI1_SS",
         /** Global Secondary Index 1 - String partition, Numeric sort */
         GSI1_SN: "GSI1_SN",
+        /** Global Secondary Index 2 - String partition, String sort (status-based queries) */
+        GSI2_SS: "GSI2_SS",
         /** Local Secondary Index 1 - String sort key */
         LSI1_S: "LSI1_S",
         /** Local Secondary Index 1 - Numeric sort key */

package/dist/repository.d.ts

@@ -3,6 +3,7 @@ import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
 import type { NativeAttributeValue } from "@aws-sdk/util-dynamodb";
 import { type AuditConfig } from "./config.js";
 import { type Audit } from "./schema/audit.js";
+import type { AnyStatus } from "./schema/log.js";
 import { type Pagination } from "./schema/model.js";
 import type { UpsertAuditInput } from "./schema/service.js";
 import type { AnyApp, AnyResourceType, InferApp, InferResourceType } from "./types.js";
@@ -87,6 +88,25 @@ export type TypedListTraceItems<C extends AuditConfig> = {
         id?: string;
     };
 };
+/**
+ * Options for listing audit items by status with typed App and ResourceType.
+ * @typeParam C - The audit config type for type inference
+ */
+export type TypedListByStatusOptions<C extends AuditConfig> = {
+    /** Tenant/organization identifier for multi-tenancy support (optional) */
+    tenantId?: string;
+    /** Status to filter by (success, warn, fail, skip) */
+    status: AnyStatus;
+    /** Optional application filter */
+    app?: InferApp<C>;
+    /** Optional resource filter */
+    resource?: {
+        /** Filter by resource type */
+        type?: InferResourceType<C>;
+        /** Filter by resource ID */
+        id?: string;
+    };
+};
 /**
  * Repository for managing audit records in DynamoDB.
  *
@@ -276,6 +296,8 @@ export declare class AuditRepository<C extends AuditConfig> {
                 id?: string | number | undefined;
             };
             operation: string;
+            updatedAt?: string | undefined;
+            createdAt?: string | undefined;
             tenantId?: string | undefined;
             source?: {
                 app: string;
@@ -346,6 +368,62 @@ export declare class AuditRepository<C extends AuditConfig> {
                 id?: string | number | undefined;
             };
             operation: string;
+            updatedAt?: string | undefined;
+            createdAt?: string | undefined;
+            tenantId?: string | undefined;
+            source?: {
+                app: string;
+                type: string;
+                id?: string | number | undefined;
+            } | undefined;
+            context?: Record<string, string | number | boolean | {
+                [key: string]: string | number | boolean | /*elided*/ any;
+            }> | undefined;
+            message?: string | undefined;
+            rerunable?: boolean | undefined;
+            trace?: string | undefined;
+            event?: {
+                detail: string | undefined;
+                source?: string | undefined;
+                "detail-type"?: string | undefined;
+            } | undefined;
+            error?: any;
+            attempts?: {
+                number: number;
+                status: "success" | "warn" | "fail" | "skip";
+                at: string;
+                error?: any;
+            }[] | undefined;
+        }[];
+        pagination?: {
+            pageSize?: string | number | null | undefined;
+            nextToken?: string | null | undefined;
+        } | undefined;
+    }>;
+    /**
+     * Lists audit records by status with date ordering and optional filters.
+     *
+     * Queries the GSI2_SS index to retrieve all audits with a specific status,
+     * ordered by creation date (most recent first by default).
+     * Supports optional filtering by app, resource type, and resource ID.
+     *
+     * @param params - Query parameters including status and optional filters
+     * @param pagination - Optional pagination settings (pageSize, nextToken)
+     * @returns Paginated collection of audit records in reverse date order
+     */
+    listByStatus(params: TypedListByStatusOptions<C>, pagination?: Pagination): Promise<{
+        items: {
+            id: string;
+            status: "success" | "warn" | "fail" | "skip";
+            tier: number;
+            target: {
+                app: string;
+                type: string;
+                id?: string | number | undefined;
+            };
+            operation: string;
+            updatedAt?: string | undefined;
+            createdAt?: string | undefined;
             tenantId?: string | undefined;
             source?: {
                 app: string;
@@ -423,6 +501,18 @@ export declare class AuditRepository<C extends AuditConfig> {
      * @internal
      */
     private constructGSI1_SN;
+    /**
+     * Constructs GSI2_SS (String-String) index keys for status-based queries.
+     *
+     * The partition key is the status value (optionally prefixed with tenantId),
+     * and the sort key combines createdAt timestamp with id for date ordering
+     * while ensuring uniqueness.
+     *
+     * @param item - The audit storage item
+     * @returns GSI2_SS key attributes
+     * @internal
+     */
+    private constructGSI2_SS;
     /**
      * Constructs the TTL attribute for automatic item expiration.
      *
@@ -459,5 +549,13 @@ export declare class AuditRepository<C extends AuditConfig> {
      * @internal
      */
     private transformListItem;
+    /**
+     * Transforms a status listing item into an audit list item payload.
+     *
+     * @param item - Raw listing item from GSI2_SS query
+     * @returns Parsed audit list item payload
+     * @internal
+     */
+    private transformStatusListItem;
 }
 //# sourceMappingURL=repository.d.ts.map

package/dist/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"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"}

package/dist/repository.js

@@ -3,7 +3,7 @@ import { marshall, unmarshall } from "@aws-sdk/util-dynamodb";
 import { DEFAULT_TTL_SECONDS } from "./config.js";
 import { DynamoDB } from "./constants.js";
 import { decodeNextPageToken, encodeNextPageToken } from "./repository.utils.js";
-import { AuditListItemPayloadSchema, AuditPayloadSchema, AuditSchema, } from "./schema/audit.js";
+import { AuditPayloadSchema, AuditSchema } from "./schema/audit.js";
 import { PaginationCollectionSchema } from "./schema/model.js";
 import { AuditStorageSchema } from "./schema/storage.js";
 import { getTraceParts } from "./utils.js";
@@ -447,6 +447,74 @@ export class AuditRepository {
             },
         });
     }
+    /**
+     * Lists audit records by status with date ordering and optional filters.
+     *
+     * Queries the GSI2_SS index to retrieve all audits with a specific status,
+     * ordered by creation date (most recent first by default).
+     * Supports optional filtering by app, resource type, and resource ID.
+     *
+     * @param params - Query parameters including status and optional filters
+     * @param pagination - Optional pagination settings (pageSize, nextToken)
+     * @returns Paginated collection of audit records in reverse date order
+     */
+    async listByStatus(params, pagination) {
+        const startKey = decodeNextPageToken(pagination?.nextToken);
+        const pageSize = Number(pagination?.pageSize || 100);
+        const pkBase = params.status;
+        const pk = params.tenantId ? `${params.tenantId}#${pkBase}` : pkBase;
+        const filters = [];
+        const ExpressionAttributeValues = {
+            ":PK": pk,
+        };
+        const ExpressionAttributeNames = {
+            "#PK": DynamoDB.Keys.GSI2_SS_PARTITION_KEY,
+        };
+        if (params?.resource?.id) {
+            Object.assign(ExpressionAttributeValues, {
+                ":resourceId": params.resource.id,
+            });
+            ExpressionAttributeNames["#target"] = "target";
+            ExpressionAttributeNames["#id"] = "id";
+            filters.push("#target.#id = :resourceId");
+        }
+        if (params?.resource?.type) {
+            Object.assign(ExpressionAttributeValues, {
+                ":resourceType": params.resource.type,
+            });
+            ExpressionAttributeNames["#target"] = "target";
+            ExpressionAttributeNames["#type"] = "type";
+            filters.push("#target.#type = :resourceType");
+        }
+        if (params?.app) {
+            Object.assign(ExpressionAttributeValues, {
+                ":app": params.app,
+            });
+            ExpressionAttributeNames["#target"] = "target";
+            ExpressionAttributeNames["#app"] = "app";
+            filters.push("#target.#app = :app");
+        }
+        // Audits with other resources will have a compound id, filter these out
+        Object.assign(ExpressionAttributeValues, { ":isParent": "#" });
+        filters.push("not contains(SK, :isParent)");
+        const { Items: items, LastEvaluatedKey: lastEvaluatedKey } = await this.client.send(new QueryCommand({
+            ScanIndexForward: false,
+            IndexName: DynamoDB.Indexes.GSI2_SS,
+            ExpressionAttributeValues: marshall(ExpressionAttributeValues),
+            ExpressionAttributeNames,
+            KeyConditionExpression: "#PK = :PK",
+            TableName: DynamoDB.Table.Name(),
+            Limit: pageSize,
+            ExclusiveStartKey: startKey ? marshall(startKey) : undefined,
+            FilterExpression: filters.length > 0 ? filters.join(" AND ") : undefined,
+        }));
+        return PaginationCollectionSchema(AuditPayloadSchema).parse({
+            items: items?.map((i) => this.transformStatusListItem(unmarshall(i))),
+            pagination: {
+                nextToken: lastEvaluatedKey ? encodeNextPageToken(unmarshall(lastEvaluatedKey)) : undefined,
+            },
+        });
+    }
     /**
      * Constructs the DynamoDB primary key from identifiers.
      *
@@ -486,6 +554,7 @@ export class AuditRepository {
                 app: item.target.app,
             }),
             ...this.constructGSI1_SN(item),
+            ...this.constructGSI2_SS(item),
         };
     }
     /**
@@ -532,6 +601,26 @@ export class AuditRepository {
             [DynamoDB.Keys.GSI1_SN_SORT_KEY]: stage,
         };
     }
+    /**
+     * Constructs GSI2_SS (String-String) index keys for status-based queries.
+     *
+     * The partition key is the status value (optionally prefixed with tenantId),
+     * and the sort key combines createdAt timestamp with id for date ordering
+     * while ensuring uniqueness.
+     *
+     * @param item - The audit storage item
+     * @returns GSI2_SS key attributes
+     * @internal
+     */
+    constructGSI2_SS(item) {
+        const pkBase = item.status;
+        return {
+            [DynamoDB.Keys.GSI2_SS_PARTITION_KEY]: (item.tenantId
+                ? `${item.tenantId}#${pkBase}`
+                : pkBase),
+            [DynamoDB.Keys.GSI2_SS_SORT_KEY]: `${item.createdAt}#${item.id}`,
+        };
+    }
     /**
      * Constructs the TTL attribute for automatic item expiration.
      *
@@ -575,7 +664,7 @@ export class AuditRepository {
      */
     transformTraceListItem(item) {
         const [id] = item.SK.split("#");
-        return AuditListItemPayloadSchema.parse({
+        return AuditPayloadSchema.parse({
             trace: `${item.GSI1_SN_PK}:${item.GSI1_SN_SK}`,
             ...item,
             id: id,
@@ -590,10 +679,28 @@ export class AuditRepository {
      */
     transformListItem(item) {
         const [id] = item.SK.split("#");
-        return AuditListItemPayloadSchema.parse({
+        return AuditPayloadSchema.parse({
             trace: `${item.GSI1_SN_PK}:${item.GSI1_SN_SK}`,
             ...item,
             id: id,
         });
     }
+    /**
+     * Transforms a status listing item into an audit list item payload.
+     *
+     * @param item - Raw listing item from GSI2_SS query
+     * @returns Parsed audit list item payload
+     * @internal
+     */
+    transformStatusListItem(item) {
+        const [id] = item.SK.split("#");
+        const trace = item.GSI1_SN_PK !== undefined && item.GSI1_SN_SK !== undefined
+            ? `${item.GSI1_SN_PK}:${item.GSI1_SN_SK}`
+            : undefined;
+        return AuditPayloadSchema.parse({
+            trace,
+            ...item,
+            id: id,
+        });
+    }
 }

package/dist/schema/audit.d.ts

@@ -92,6 +92,8 @@ export type Audit = z.output<typeof AuditSchema>;
  * suitable for JSON serialization in API responses.
  */
 export declare const AuditPayloadSchema: z.ZodObject<{
+    updatedAt: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodCustom<Date, Date>]>, z.ZodTransform<string, string | Date>>>;
+    createdAt: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodCustom<Date, Date>]>, z.ZodTransform<string, string | Date>>>;
     id: z.ZodString;
     tenantId: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
@@ -142,61 +144,4 @@ export declare const AuditPayloadSchema: z.ZodObject<{
  * Output type for audit payloads.
  */
 export type AuditPayload = z.output<typeof AuditPayloadSchema>;
-/**
- * Schema for audit list item payloads.
- *
- * Same as AuditPayloadSchema, used for items in list responses
- * where a lighter payload is sufficient.
- */
-export declare const AuditListItemPayloadSchema: z.ZodObject<{
-    id: z.ZodString;
-    tenantId: z.ZodOptional<z.ZodString>;
-    status: z.ZodEnum<{
-        success: "success";
-        warn: "warn";
-        fail: "fail";
-        skip: "skip";
-    }>;
-    tier: z.ZodDefault<z.ZodNumber>;
-    target: z.ZodObject<{
-        app: z.ZodString;
-        id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-        type: z.ZodString;
-    }, z.core.$strip>;
-    source: z.ZodOptional<z.ZodObject<{
-        app: z.ZodString;
-        id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-        type: z.ZodString;
-    }, z.core.$strip>>;
-    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<string | number | boolean | {
-        [key: string]: string | number | boolean | /*elided*/ any;
-    }, unknown, z.core.$ZodTypeInternals<string | number | boolean | {
-        [key: string]: string | number | boolean | /*elided*/ any;
-    }, unknown>>>>;
-    operation: z.ZodString;
-    message: z.ZodOptional<z.ZodString>;
-    rerunable: z.ZodOptional<z.ZodBoolean>;
-    trace: z.ZodOptional<z.ZodString>;
-    event: z.ZodOptional<z.ZodObject<{
-        source: z.ZodOptional<z.ZodString>;
-        "detail-type": z.ZodOptional<z.ZodString>;
-        detail: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>>, z.ZodTransform<string | undefined, string | Record<string, any> | undefined>>;
-    }, z.core.$strip>>;
-    error: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodPipe<z.ZodCustom<Error, Error>, z.ZodTransform<any, Error>>, z.ZodRecord<z.ZodAny, z.ZodAny>]>>;
-    attempts: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        number: z.ZodNumber;
-        status: z.ZodEnum<{
-            success: "success";
-            warn: "warn";
-            fail: "fail";
-            skip: "skip";
-        }>;
-        error: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodPipe<z.ZodCustom<Error, Error>, z.ZodTransform<any, Error>>, z.ZodRecord<z.ZodAny, z.ZodAny>]>>;
-        at: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodCustom<Date, Date>]>, z.ZodTransform<string, string | Date>>>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-/**
- * Output type for audit list item payloads.
- */
-export type AuditAuditListItemPayload = z.output<typeof AuditListItemPayloadSchema>;
 //# sourceMappingURL=audit.d.ts.map

package/dist/schema/audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/schema/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMtB,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAa,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/schema/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMtB,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM7B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/schema/audit.js

@@ -1,5 +1,5 @@
 import * as z from "zod/v4";
-import { BaseSchema, DateTimeObjectSchema } from "./common.js";
+import { BaseSchema, DateTimeObjectSchema, DateTimeStringSchema } from "./common.js";
 /**
  * Schema for fully-hydrated audit records retrieved from storage.
  *
@@ -38,11 +38,10 @@ export const AuditSchema = z.object({
  * Uses the base schema without timestamp transformation,
  * suitable for JSON serialization in API responses.
  */
-export const AuditPayloadSchema = BaseSchema;
-/**
- * Schema for audit list item payloads.
- *
- * Same as AuditPayloadSchema, used for items in list responses
- * where a lighter payload is sufficient.
- */
-export const AuditListItemPayloadSchema = BaseSchema;
+export const AuditPayloadSchema = z.object({
+    ...BaseSchema.shape,
+    /** Last update timestamp - ISO string suitable for JSON API responses */
+    updatedAt: DateTimeStringSchema.optional(),
+    /** Creation timestamp - ISO string suitable for JSON API responses */
+    createdAt: DateTimeStringSchema.optional(),
+});

package/dist/service.d.ts

@@ -3,6 +3,7 @@ import type { AuditConfig } from "./config.js";
 import { AuditEventBus } from "./events/bus.js";
 import { AuditRepository } from "./repository.js";
 import type { Audit } from "./schema/audit.js";
+import type { AnyStatus } from "./schema/log.js";
 import type { Pagination } from "./schema/model.js";
 import { type UpsertAuditInput } from "./schema/service.js";
 import type { InferApp, InferResourceType } from "./types.js";
@@ -58,6 +59,25 @@ export type TypedListTraceItems<C extends AuditConfig> = {
         id?: string;
     };
 };
+/**
+ * Typed options for listing audit items by status.
+ * Uses config-derived App and ResourceType types for strict typing.
+ */
+export type TypedListByStatusOptions<C extends AuditConfig> = {
+    /** Tenant/organization identifier for multi-tenancy support (optional) */
+    tenantId?: string;
+    /** Status to filter by (success, warn, fail, skip) */
+    status: AnyStatus;
+    /** Optional application filter */
+    app?: InferApp<C>;
+    /** Optional resource filter */
+    resource?: {
+        /** Filter by resource type */
+        type?: InferResourceType<C>;
+        /** Filter by resource ID */
+        id?: string;
+    };
+};
 /**
  * High-level service for managing audit records with typed App and ResourceType.
  *
@@ -192,6 +212,8 @@ export declare class AuditService<C extends AuditConfig> {
                 id?: string | number | undefined;
             };
             operation: string;
+            updatedAt?: string | undefined;
+            createdAt?: string | undefined;
             tenantId?: string | undefined;
             source?: {
                 app: string;
@@ -251,6 +273,63 @@ export declare class AuditService<C extends AuditConfig> {
                 id?: string | number | undefined;
             };
             operation: string;
+            updatedAt?: string | undefined;
+            createdAt?: string | undefined;
+            tenantId?: string | undefined;
+            source?: {
+                app: string;
+                type: string;
+                id?: string | number | undefined;
+            } | undefined;
+            context?: Record<string, string | number | boolean | {
+                [key: string]: string | number | boolean | /*elided*/ any;
+            }> | undefined;
+            message?: string | undefined;
+            rerunable?: boolean | undefined;
+            trace?: string | undefined;
+            event?: {
+                detail: string | undefined;
+                source?: string | undefined;
+                "detail-type"?: string | undefined;
+            } | undefined;
+            error?: any;
+            attempts?: {
+                number: number;
+                status: "success" | "warn" | "fail" | "skip";
+                at: string;
+                error?: any;
+            }[] | undefined;
+        }[];
+        pagination?: {
+            pageSize?: string | number | null | undefined;
+            nextToken?: string | null | undefined;
+        } | undefined;
+    }>;
+    /**
+     * Lists audit records by status with date ordering and pagination.
+     *
+     * Retrieves all audits with a specific status (e.g., 'fail', 'warn'),
+     * ordered by creation date (most recent first).
+     * Supports optional filtering by app, resource type, and resource ID.
+     *
+     * @param params - Query parameters including status and optional filters
+     * @param pagination - Optional pagination settings
+     * @returns Paginated collection of status-filtered audit records
+     * @throws Re-throws any storage errors after logging
+     */
+    listByStatus(params: TypedListByStatusOptions<C>, pagination?: Pagination): Promise<{
+        items: {
+            id: string;
+            status: "success" | "warn" | "fail" | "skip";
+            tier: number;
+            target: {
+                app: string;
+                type: string;
+                id?: string | number | undefined;
+            };
+            operation: string;
+            updatedAt?: string | undefined;
+            createdAt?: string | undefined;
             tenantId?: string | undefined;
             source?: {
                 app: string;

package/dist/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/dist/service.js

@@ -212,4 +212,27 @@ export class AuditService {
             throw error;
         }
     }
+    /**
+     * Lists audit records by status with date ordering and pagination.
+     *
+     * Retrieves all audits with a specific status (e.g., 'fail', 'warn'),
+     * ordered by creation date (most recent first).
+     * Supports optional filtering by app, resource type, and resource ID.
+     *
+     * @param params - Query parameters including status and optional filters
+     * @param pagination - Optional pagination settings
+     * @returns Paginated collection of status-filtered audit records
+     * @throws Re-throws any storage errors after logging
+     */
+    async listByStatus(params, pagination) {
+        try {
+            return await this.storage.listByStatus(params, pagination);
+        }
+        catch (error) {
+            this.logger.error("An error occurred while trying to list items by status", {
+                error,
+            });
+            throw error;
+        }
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flipboxlabs/aws-audit-sdk",
-  "version": "1.2.3",
+  "version": "1.4.0",
   "description": "AWS Audit SDK - Core SDK for audit logging and event management",
   "keywords": [
     "audit",