@atlasauth/backend 0.5.0 → 0.7.0

package/dist/client/audit-events.d.ts

@@ -0,0 +1,103 @@
+import { type RequestFn } from './request';
+import type { CursorPage, CursorParams } from './types';
+/**
+ * Your OWN audit events — actions in your product you want on an audit trail
+ * (e.g. `invoice.sent`). Org-scoped events are streamed to that organization's
+ * audit streams. Separate from `auditLogs`, which records what happened in Atlas.
+ */
+export interface CustomAuditEvent {
+    object: 'audit_event';
+    id: string;
+    /** The org this event is scoped to, if any. */
+    organization_id?: string | null;
+    /** Your own actor vocabulary, e.g. `user`, `service`. */
+    actor: {
+        type?: string;
+        id?: string | null;
+    };
+    /** Your own action string, e.g. `invoice.sent`. */
+    action: string;
+    target: {
+        type?: string | null;
+        id?: string | null;
+        name?: string | null;
+    };
+    /** When it happened in your system (epoch ms). */
+    occurred_at: number;
+    metadata: unknown;
+    /** When Atlas received it (epoch ms). */
+    created_at: number;
+}
+export interface CreateCustomAuditEventBody {
+    actor: {
+        type: string;
+        id?: string;
+    };
+    action: string;
+    target?: {
+        type?: string;
+        id?: string;
+        name?: string;
+    };
+    /** Scope to an org (and stream to its SIEM). An unknown org id is a 404. */
+    organization_id?: string;
+    /** Epoch ms NUMBER; defaults to now. */
+    occurred_at?: number;
+    /** Non-secret structured context. */
+    metadata?: Record<string, unknown>;
+}
+/** Shared filters of the list and export endpoints. */
+export interface CustomAuditEventFilters {
+    /** Omit to query across all organizations (a blank value is a 400). */
+    organization_id?: string;
+    /** One id, or a comma-separated list (matches any). */
+    actor_id?: string;
+    /** One action, or a comma-separated list. */
+    action?: string;
+    /** One type, or a comma-separated list. */
+    target_type?: string;
+    /** One id, or a comma-separated list. */
+    target_id?: string;
+    /** Inclusive lower bound of occurred_at (epoch ms). */
+    from?: number;
+    /** Upper bound of occurred_at (epoch ms). */
+    to?: number;
+    /** OR the actor_id / target_type / target_id filters instead of AND. */
+    any_of?: boolean;
+    /** Give together with `metadata_value`: match events whose metadata[key] equals the value. */
+    metadata_key?: string;
+    metadata_value?: string;
+}
+export interface ListCustomAuditEventsParams extends CustomAuditEventFilters, CursorParams {
+}
+export interface ExportCustomAuditEventsParams extends CustomAuditEventFilters {
+    /** `jsonl` (default) or `csv`. */
+    format?: 'jsonl' | 'csv';
+    starting_after?: string;
+}
+export declare function auditEventsResource(request: RequestFn): {
+    create(body: CreateCustomAuditEventBody, idempotencyKey?: string): Promise<CustomAuditEvent>;
+    /** Up to 100 events, stored atomically (one bad org id fails the whole batch). */
+    createBatch(events: CreateCustomAuditEventBody[], idempotencyKey?: string): Promise<{
+        object: "list";
+        data: CustomAuditEvent[];
+    }>;
+    /** Newest first, cursor-paginated. */
+    list(params?: ListCustomAuditEventsParams): Promise<CursorPage<CustomAuditEvent>>;
+    /**
+     * Every matching event in one response, as text: JSONL (one event per line;
+     * a capped export ends with a `{"truncated":true,…}` line) or CSV.
+     */
+    export(params?: ExportCustomAuditEventsParams): Promise<string>;
+    /**
+     * Test-mode reset: delete the custom audit events of a DEVELOPMENT instance,
+     * optionally only one org's and/or one action's. A production instance is a 403.
+     */
+    deleteAll(params?: {
+        organization_id?: string;
+        action?: string;
+    }): Promise<{
+        object: "audit_events.bulk_delete";
+        deleted: number;
+    }>;
+};

package/dist/client/audit-events.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auditEventsResource = auditEventsResource;
+function auditEventsResource(request) {
+    return {
+        create(body, idempotencyKey) {
+            return request({ method: 'POST', path: '/v1/audit_events', body, idempotencyKey });
+        },
+        /** Up to 100 events, stored atomically (one bad org id fails the whole batch). */
+        createBatch(events, idempotencyKey) {
+            return request({
+                method: 'POST',
+                path: '/v1/audit_events/batch',
+                body: { events },
+                idempotencyKey,
+            });
+        },
+        /** Newest first, cursor-paginated. */
+        list(params = {}) {
+            return request({ method: 'GET', path: '/v1/audit_events', query: { ...params } });
+        },
+        /**
+         * Every matching event in one response, as text: JSONL (one event per line;
+         * a capped export ends with a `{"truncated":true,…}` line) or CSV.
+         */
+        export(params = {}) {
+            return request({
+                method: 'GET',
+                path: '/v1/audit_events/export',
+                query: { ...params },
+                raw: true,
+            });
+        },
+        /**
+         * Test-mode reset: delete the custom audit events of a DEVELOPMENT instance,
+         * optionally only one org's and/or one action's. A production instance is a 403.
+         */
+        deleteAll(params = {}) {
+            return request({ method: 'DELETE', path: '/v1/audit_events', query: { ...params } });
+        },
+    };
+}
+//# sourceMappingURL=audit-events.js.map

package/dist/client/audit-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-events.js","sourceRoot":"","sources":["../../src/client/audit-events.ts"],"names":[],"mappings":";;AAoEA,kDA2CC;AA3CD,SAAgB,mBAAmB,CAAC,OAAkB;IACpD,OAAO;QACL,MAAM,CAAC,IAAgC,EAAE,cAAuB;YAC9D,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,kFAAkF;QAClF,WAAW,CACT,MAAoC,EACpC,cAAuB;YAEvB,OAAO,OAAO,CAAC;gBACb,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,wBAAwB;gBAC9B,IAAI,EAAE,EAAE,MAAM,EAAE;gBAChB,cAAc;aACf,CAAC,CAAC;QACL,CAAC;QACD,sCAAsC;QACtC,IAAI,CAAC,SAAsC,EAAE;YAC3C,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;QACD;;;WAGG;QACH,MAAM,CAAC,SAAwC,EAAE;YAC/C,OAAO,OAAO,CAAC;gBACb,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,yBAAyB;gBAC/B,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE;gBACpB,GAAG,EAAE,IAAI;aACV,CAAC,CAAC;QACL,CAAC;QACD;;;WAGG;QACH,SAAS,CACP,SAAwD,EAAE;YAE1D,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;QACvF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/client/billing-plans.d.ts

@@ -67,6 +67,37 @@ export interface ListSubscriptionsParams {
     subject_type?: string;
     subject_id?: string;
 }
+/** Adopt an existing Stripe subscription (same Stripe account) onto an Atlas subject. */
+export interface ImportBillingSubscriptionBody {
+    subject_type: 'user' | 'org';
+    subject_id: string;
+    stripe_subscription_id: string;
+    stripe_customer_id?: string;
+    /** Resolved from the subscription's price when omitted. */
+    plan_id?: string;
+}
+/** Report metered usage for a subject. Idempotent on `idempotency_key`. */
+export interface ReportBillingUsageBody {
+    subject_type: 'user' | 'org';
+    subject_id: string;
+    /** Non-negative. */
+    quantity: number;
+    idempotency_key: string;
+}
+export interface BillingUsageReport {
+    object: 'billing_usage';
+    /** False when this `idempotency_key` was already recorded. */
+    recorded: boolean;
+    /** Whether it was mirrored to a Stripe meter (the plan is metered and configured). */
+    metered: boolean;
+    total: number;
+}
+export interface BillingSeatSync {
+    object: 'billing_seats';
+    subject_type: string;
+    subject_id: string;
+    quantity: number;
+}
 export declare function billingResource(request: RequestFn): {
     listPlans(): Promise<ListPage<BillingPlan>>;
     createPlan(body: CreateBillingPlanBody, idempotencyKey?: string): Promise<BillingPlan>;
@@ -78,4 +109,16 @@ export declare function billingResource(request: RequestFn): {
         deleted: true;
     }>;
     listSubscriptions(params?: ListSubscriptionsParams): Promise<ListPage<BillingSubscription>>;
+    /**
+     * Adopt an EXISTING Stripe subscription onto a user/org + plan, for
+     * migrating billing into Atlas without re-charging. Read-only on Stripe.
+     */
+    importSubscription(body: ImportBillingSubscriptionBody, idempotencyKey?: string): Promise<BillingSubscription>;
+    /** Report metered usage (mirrored to a Stripe meter event when the plan is metered). */
+    reportUsage(body: ReportBillingUsageBody): Promise<BillingUsageReport>;
+    /**
+     * Sync a per-seat subscription's Stripe quantity to the org's current member
+     * count (prorated). Never changes the paid status.
+     */
+    syncSeats(subjectType: "user" | "org", subjectId: string): Promise<BillingSeatSync>;
 };

package/dist/client/billing-plans.js

@@ -22,6 +22,32 @@ function billingResource(request) {
         listSubscriptions(params) {
             return request({ method: 'GET', path: '/v1/billing/subscriptions', query: { ...params } });
         },
+        /**
+         * Adopt an EXISTING Stripe subscription onto a user/org + plan, for
+         * migrating billing into Atlas without re-charging. Read-only on Stripe.
+         */
+        importSubscription(body, idempotencyKey) {
+            return request({
+                method: 'POST',
+                path: '/v1/billing/subscriptions/import',
+                body,
+                idempotencyKey,
+            });
+        },
+        /** Report metered usage (mirrored to a Stripe meter event when the plan is metered). */
+        reportUsage(body) {
+            return request({ method: 'POST', path: '/v1/billing/usage', body });
+        },
+        /**
+         * Sync a per-seat subscription's Stripe quantity to the org's current member
+         * count (prorated). Never changes the paid status.
+         */
+        syncSeats(subjectType, subjectId) {
+            return request({
+                method: 'POST',
+                path: `/v1/billing/subjects/${(0, request_1.enc)(subjectType)}/${(0, request_1.enc)(subjectId)}/sync_seats`,
+            });
+        },
     };
 }
 //# sourceMappingURL=billing-plans.js.map

package/dist/client/billing-plans.js.map

@@ -1 +1 @@
-{"version":3,"file":"billing-plans.js","sourceRoot":"","sources":["../../src/client/billing-plans.ts"],"names":[],"mappings":";;AA2EA,0CAqBC;AAhGD,uCAAgD;AA2EhD,SAAgB,eAAe,CAAC,OAAkB;IAChD,OAAO;QACL,SAAS;YACP,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,UAAU,CAAC,IAA2B,EAAE,cAAuB;YAC7D,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,CAAC,EAAU;YAChB,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,IAAA,aAAG,EAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,UAAU,CAAC,EAAU,EAAE,IAA2B;YAChD,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,qBAAqB,IAAA,aAAG,EAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,UAAU,CAAC,EAAU;YACnB,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,qBAAqB,IAAA,aAAG,EAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,iBAAiB,CAAC,MAAgC;YAChD,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7F,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"billing-plans.js","sourceRoot":"","sources":["../../src/client/billing-plans.ts"],"names":[],"mappings":";;AA8GA,0CAkDC;AAhKD,uCAAgD;AA8GhD,SAAgB,eAAe,CAAC,OAAkB;IAChD,OAAO;QACL,SAAS;YACP,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,UAAU,CAAC,IAA2B,EAAE,cAAuB;YAC7D,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,CAAC,EAAU;YAChB,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,IAAA,aAAG,EAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,UAAU,CAAC,EAAU,EAAE,IAA2B;YAChD,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,qBAAqB,IAAA,aAAG,EAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,UAAU,CAAC,EAAU;YACnB,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,qBAAqB,IAAA,aAAG,EAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,iBAAiB,CAAC,MAAgC;YAChD,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD;;;WAGG;QACH,kBAAkB,CAChB,IAAmC,EACnC,cAAuB;YAEvB,OAAO,OAAO,CAAC;gBACb,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,kCAAkC;gBACxC,IAAI;gBACJ,cAAc;aACf,CAAC,CAAC;QACL,CAAC;QACD,wFAAwF;QACxF,WAAW,CAAC,IAA4B;YACtC,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QACD;;;WAGG;QACH,SAAS,CAAC,WAA2B,EAAE,SAAiB;YACtD,OAAO,OAAO,CAAC;gBACb,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,wBAAwB,IAAA,aAAG,EAAC,WAAW,CAAC,IAAI,IAAA,aAAG,EAAC,SAAS,CAAC,aAAa;aAC9E,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/client/connectors.d.ts

@@ -0,0 +1,174 @@
+import { type RequestFn } from './request';
+/** How an installing instance gets OAuth credentials for a connector. */
+export type ConnectorShareMode = 'prefill' | 'full_shared' | 'full_idp';
+/**
+ * A community connector profile you publish to the connector directory: its
+ * public listing, OAuth config and share modes. The shared client secret is
+ * never returned.
+ */
+export interface CommunityConnector {
+    object: 'connector';
+    id: string;
+    slug: string;
+    display_name: string;
+    logo_url?: string | null;
+    tagline?: string | null;
+    description?: string | null;
+    category: string;
+    tags: unknown[];
+    website_url?: string | null;
+    docs_url?: string | null;
+    support_url?: string | null;
+    setup_guide?: string | null;
+    protocol: string;
+    authorization_endpoint?: string | null;
+    token_endpoint?: string | null;
+    userinfo_endpoint?: string | null;
+    issuer?: string | null;
+    default_scopes: string[];
+    api_scopes?: unknown[];
+    credential_fields?: unknown[];
+    share_modes: ConnectorShareMode[];
+    shared_client_id?: string | null;
+    shared_revoked: boolean;
+    idp_issuer?: string | null;
+    idp_auto_register: boolean;
+    status: 'draft' | 'published' | 'unlisted' | 'banned';
+    verified: boolean;
+    featured: boolean;
+    install_count: number;
+    view_count: number;
+    rating_avg: number;
+    rating_count: number;
+    /** Epoch ms. */
+    created_at: number;
+    /** Epoch ms. */
+    updated_at: number;
+}
+/** Fields of a connector profile you can set on create or update. */
+export interface UpdateCommunityConnectorBody {
+    slug?: string;
+    display_name?: string;
+    logo_url?: string;
+    tagline?: string;
+    description?: string;
+    category?: string;
+    tags?: string[];
+    website_url?: string;
+    docs_url?: string;
+    support_url?: string;
+    screenshots?: unknown[];
+    setup_guide?: string;
+    protocol?: string;
+    authorization_endpoint?: string;
+    token_endpoint?: string;
+    userinfo_endpoint?: string;
+    issuer?: string;
+    default_scopes?: string[];
+    api_scopes?: unknown[];
+    credential_fields?: unknown[];
+    authorization_params?: Record<string, unknown>;
+    quirks?: Record<string, unknown>;
+    share_modes?: ConnectorShareMode[];
+    idp_instance_id?: string;
+    idp_issuer?: string;
+    idp_auto_register?: boolean;
+}
+/** `slug` is globally unique and may not shadow a built-in provider. */
+export interface CreateCommunityConnectorBody extends UpdateCommunityConnectorBody {
+    slug: string;
+    display_name: string;
+}
+/** Set or rotate (`client_id` + `client_secret`) or revoke (`revoke: true`) the full_shared credentials. */
+export interface ConnectorSharedCredentialsBody {
+    client_id?: string;
+    client_secret?: string;
+    revoke?: boolean;
+}
+export interface InstallConnectorBody {
+    share_mode: ConnectorShareMode;
+    /** Your own credentials (prefill mode). */
+    client_id?: string;
+    client_secret?: string;
+    scopes?: string[];
+}
+export interface ConnectorInstall {
+    object: 'connector_install';
+    connector: string;
+    share_mode: string;
+    provider_key?: string;
+    /** True when the install still needs your own client credentials. */
+    needs_credentials?: boolean;
+}
+export interface ConnectorReview {
+    object: 'connector_review';
+    connector: string;
+    rating: number;
+}
+/** A directory entry (built-in provider or community connector). Keys are camelCase. */
+export interface ConnectorDirectoryEntry {
+    source: 'builtin' | 'community';
+    key: string;
+    slug: string;
+    displayName: string;
+    category: string;
+    tagline?: string | null;
+    description?: string | null;
+    logoUrl?: string | null;
+    websiteUrl?: string | null;
+    docsUrl?: string | null;
+    verified?: boolean;
+    featured?: boolean;
+    installCount?: number;
+    ratingAvg?: number;
+    ratingCount?: number;
+    rankScore?: number;
+    defaultScopes?: string[];
+    apiScopes?: unknown[];
+    credentialFields?: unknown[];
+    shareModes?: string[];
+}
+export interface ConnectorDirectoryParams {
+    category?: string;
+    /** Only verified community connectors. */
+    verified?: boolean;
+    /** Free-text search. */
+    q?: string;
+    limit?: number;
+    offset?: number;
+}
+export declare function connectorsResource(request: RequestFn): {
+    /** Your own connector profiles (draft and published). */
+    list(): Promise<{
+        object: "list";
+        data: CommunityConnector[];
+        has_more: false;
+    }>;
+    create(body: CreateCommunityConnectorBody, idempotencyKey?: string): Promise<CommunityConnector>;
+    get(id: string): Promise<CommunityConnector>;
+    update(id: string, body: UpdateCommunityConnectorBody): Promise<CommunityConnector>;
+    /** Deletes the profile and its installs, reviews and reports. */
+    delete(id: string): Promise<{
+        object: "connector";
+        id: string;
+        deleted: true;
+    }>;
+    /** List it in the public directory (unverified until reviewed). */
+    publish(id: string): Promise<CommunityConnector>;
+    /** Take it out of the directory without deleting it. */
+    unlist(id: string): Promise<CommunityConnector>;
+    /** Set, rotate or revoke the full_shared credentials. Revoking stops every install. */
+    setSharedCredentials(id: string, body: ConnectorSharedCredentialsBody): Promise<CommunityConnector>;
+    /** Enable a published connector (by slug) on this instance. */
+    install(slug: string, body: InstallConnectorBody): Promise<ConnectorInstall>;
+    /** Rate a connector you installed, 1–5, with optional text. */
+    review(slug: string, body: {
+        rating: number;
+        body?: string;
+    }): Promise<ConnectorReview>;
+    /** Browse built-in providers plus published community connectors, popular first. */
+    directory(params?: ConnectorDirectoryParams): Promise<{
+        object: "list";
+        data: ConnectorDirectoryEntry[];
+    }>;
+};

package/dist/client/connectors.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectorsResource = connectorsResource;
+const request_1 = require("./request");
+function connectorsResource(request) {
+    return {
+        /** Your own connector profiles (draft and published). */
+        list() {
+            return request({ method: 'GET', path: '/v1/connectors' });
+        },
+        create(body, idempotencyKey) {
+            return request({ method: 'POST', path: '/v1/connectors', body, idempotencyKey });
+        },
+        get(id) {
+            return request({ method: 'GET', path: `/v1/connectors/${(0, request_1.enc)(id)}` });
+        },
+        update(id, body) {
+            return request({ method: 'PATCH', path: `/v1/connectors/${(0, request_1.enc)(id)}`, body });
+        },
+        /** Deletes the profile and its installs, reviews and reports. */
+        delete(id) {
+            return request({ method: 'DELETE', path: `/v1/connectors/${(0, request_1.enc)(id)}` });
+        },
+        /** List it in the public directory (unverified until reviewed). */
+        publish(id) {
+            return request({ method: 'POST', path: `/v1/connectors/${(0, request_1.enc)(id)}/publish` });
+        },
+        /** Take it out of the directory without deleting it. */
+        unlist(id) {
+            return request({ method: 'POST', path: `/v1/connectors/${(0, request_1.enc)(id)}/unlist` });
+        },
+        /** Set, rotate or revoke the full_shared credentials. Revoking stops every install. */
+        setSharedCredentials(id, body) {
+            return request({
+                method: 'POST',
+                path: `/v1/connectors/${(0, request_1.enc)(id)}/shared_credentials`,
+                body,
+            });
+        },
+        /** Enable a published connector (by slug) on this instance. */
+        install(slug, body) {
+            return request({ method: 'POST', path: `/v1/connectors/${(0, request_1.enc)(slug)}/install`, body });
+        },
+        /** Rate a connector you installed, 1–5, with optional text. */
+        review(slug, body) {
+            return request({ method: 'POST', path: `/v1/connectors/${(0, request_1.enc)(slug)}/reviews`, body });
+        },
+        /** Browse built-in providers plus published community connectors, popular first. */
+        directory(params = {}) {
+            return request({ method: 'GET', path: '/v1/directory', query: { ...params } });
+        },
+    };
+}
+//# sourceMappingURL=connectors.js.map

package/dist/client/connectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.js","sourceRoot":"","sources":["../../src/client/connectors.ts"],"names":[],"mappings":";;AAsJA,gDAwDC;AA9MD,uCAAgD;AAsJhD,SAAgB,kBAAkB,CAAC,OAAkB;IACnD,OAAO;QACL,yDAAyD;QACzD,IAAI;YACF,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,CACJ,IAAkC,EAClC,cAAuB;YAEvB,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,GAAG,CAAC,EAAU;YACZ,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,IAAA,aAAG,EAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,CAAC,EAAU,EAAE,IAAkC;YACnD,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,IAAA,aAAG,EAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,iEAAiE;QACjE,MAAM,CAAC,EAAU;YACf,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,kBAAkB,IAAA,aAAG,EAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,mEAAmE;QACnE,OAAO,CAAC,EAAU;YAChB,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,IAAA,aAAG,EAAC,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,wDAAwD;QACxD,MAAM,CAAC,EAAU;YACf,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,IAAA,aAAG,EAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,uFAAuF;QACvF,oBAAoB,CAClB,EAAU,EACV,IAAoC;YAEpC,OAAO,OAAO,CAAC;gBACb,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,kBAAkB,IAAA,aAAG,EAAC,EAAE,CAAC,qBAAqB;gBACpD,IAAI;aACL,CAAC,CAAC;QACL,CAAC;QACD,+DAA+D;QAC/D,OAAO,CAAC,IAAY,EAAE,IAA0B;YAC9C,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,IAAA,aAAG,EAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,+DAA+D;QAC/D,MAAM,CAAC,IAAY,EAAE,IAAuC;YAC1D,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,IAAA,aAAG,EAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,oFAAoF;QACpF,SAAS,CACP,SAAmC,EAAE;YAErC,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;QACjF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/client/data-subject-requests.d.ts

@@ -17,6 +17,8 @@ export interface DataSubjectRequest {
     requested_by_id: string | null;
     reason: string | null;
     scheduled_for: number | null;
+    /** Estimated completion (epoch ms): an erasure's grace deadline; null for an export. */
+    eta?: number | null;
     requested_at: number;
     updated_at: number;
     completed_at: number | null;
@@ -28,7 +30,26 @@ export interface ListDataSubjectRequestsParams extends CursorParams {
     status?: string;
     user_id?: string;
 }
+/** Identify the subject by `user_id` OR `subject_email` (`user_id` wins if both are given). */
+export interface CreateDataSubjectRequestBody {
+    type: 'export' | 'erasure';
+    user_id?: string;
+    /** The subject's email (verified, else unverified), resolved to the user. */
+    subject_email?: string;
+    reason?: string;
+}
 export declare function dataSubjectRequestsResource(request: RequestFn): {
+    /**
+     * Open an export or erasure request for a user from the backend. Same worker,
+     * grace window and webhooks as the self-service flow; idempotent on an
+     * in-flight request.
+     */
+    create(body: CreateDataSubjectRequestBody, idempotencyKey?: string): Promise<DataSubjectRequest>;
+    /**
+     * Cancel a scheduled erasure inside its grace window. Once processing or
+     * terminal it is a 409; exports are not cancellable.
+     */
+    cancel(id: string): Promise<DataSubjectRequest>;
     list(params?: ListDataSubjectRequestsParams): Promise<CursorPage<DataSubjectRequest>>;
     get(id: string): Promise<DataSubjectRequest>;
     /** Fulfil a request now — build the export package, or run the erasure — ahead of schedule. */

package/dist/client/data-subject-requests.js

@@ -4,6 +4,21 @@ exports.dataSubjectRequestsResource = dataSubjectRequestsResource;
 const request_1 = require("./request");
 function dataSubjectRequestsResource(request) {
     return {
+        /**
+         * Open an export or erasure request for a user from the backend. Same worker,
+         * grace window and webhooks as the self-service flow; idempotent on an
+         * in-flight request.
+         */
+        create(body, idempotencyKey) {
+            return request({ method: 'POST', path: '/v1/data_subject_requests', body, idempotencyKey });
+        },
+        /**
+         * Cancel a scheduled erasure inside its grace window. Once processing or
+         * terminal it is a 409; exports are not cancellable.
+         */
+        cancel(id) {
+            return request({ method: 'POST', path: `/v1/data_subject_requests/${(0, request_1.enc)(id)}/cancel` });
+        },
         list(params = {}) {
             return request({ method: 'GET', path: '/v1/data_subject_requests', query: { ...params } });
         },

package/dist/client/data-subject-requests.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-subject-requests.js","sourceRoot":"","sources":["../../src/client/data-subject-requests.ts"],"names":[],"mappings":";;AAiCA,kEAgCC;AAjED,uCAAgD;AAiChD,SAAgB,2BAA2B,CAAC,OAAkB;IAC5D,OAAO;QACL,IAAI,CACF,SAAwC,EAAE;YAE1C,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,GAAG,CAAC,EAAU;YACZ,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,6BAA6B,IAAA,aAAG,EAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,+FAA+F;QAC/F,OAAO,CAAC,EAAU,EAAE,cAAuB;YACzC,OAAO,OAAO,CAAC;gBACb,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,6BAA6B,IAAA,aAAG,EAAC,EAAE,CAAC,UAAU;gBACpD,cAAc;aACf,CAAC,CAAC;QACL,CAAC;QACD,oFAAoF;QACpF,MAAM,CACJ,EAAU,EACV,OAA4B,EAAE,EAC9B,cAAuB;YAEvB,OAAO,OAAO,CAAC;gBACb,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,6BAA6B,IAAA,aAAG,EAAC,EAAE,CAAC,SAAS;gBACnD,IAAI;gBACJ,cAAc;aACf,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"data-subject-requests.js","sourceRoot":"","sources":["../../src/client/data-subject-requests.ts"],"names":[],"mappings":";;AA4CA,kEAkDC;AA9FD,uCAAgD;AA4ChD,SAAgB,2BAA2B,CAAC,OAAkB;IAC5D,OAAO;QACL;;;;WAIG;QACH,MAAM,CACJ,IAAkC,EAClC,cAAuB;YAEvB,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD;;;WAGG;QACH,MAAM,CAAC,EAAU;YACf,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,IAAA,aAAG,EAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,CACF,SAAwC,EAAE;YAE1C,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,GAAG,CAAC,EAAU;YACZ,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,6BAA6B,IAAA,aAAG,EAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,+FAA+F;QAC/F,OAAO,CAAC,EAAU,EAAE,cAAuB;YACzC,OAAO,OAAO,CAAC;gBACb,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,6BAA6B,IAAA,aAAG,EAAC,EAAE,CAAC,UAAU;gBACpD,cAAc;aACf,CAAC,CAAC;QACL,CAAC;QACD,oFAAoF;QACpF,MAAM,CACJ,EAAU,EACV,OAA4B,EAAE,EAC9B,cAAuB;YAEvB,OAAO,OAAO,CAAC;gBACb,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,6BAA6B,IAAA,aAAG,EAAC,EAAE,CAAC,SAAS;gBACnD,IAAI;gBACJ,cAAc;aACf,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}