@terminal3/t3n-sdk 2.11.0 → 2.12.0

package/dist/src/client/t3n-client.d.ts

@@ -370,6 +370,12 @@ export declare class T3nClient {
         organisationDid?: string;
         attestations?: unknown;
         keys?: Record<string, unknown>;
+        /**
+         * MAT-1618 testnet self-admit, propagated to the inner
+         * {@link submitUserInput} call. Inspect `result.tenantAdmit` for
+         * the outcome.
+         */
+        becomeDevTenant?: boolean;
         getOtpCode: (contact: string, channel: OtpChannel) => Promise<string> | string;
     }): Promise<SubmitUserInputResult>;
     /**

package/dist/src/index.d.ts

@@ -18,7 +18,7 @@ export type { SessionId, Did, OidcCredentials, AuthInput, EthAuthInput, OidcAuth
 export { SessionStatus, AuthMethod, createEthAuthInput, createOidcAuthInput, } from "./types";
 export type { KycStatus, KycStatusKind, KycPollOptions, KycPollCadence, } from "./types/kyc";
 export { DEFAULT_KYC_POLL_CADENCE, TERMINAL_KYC_STATUSES, KycStatusTimeoutError, } from "./types/kyc";
-export type { OtpChannel, OtpRequestInput, OtpRequestResult, OtpVerifyInput, OtpVerifyResult, OtpMergeSuggestion, UserInputProfile, SubmitUserInputArgs, SubmitUserInputResult, UserUpsertErrorKind, } from "./types/user";
+export type { OtpChannel, OtpRequestInput, OtpRequestResult, OtpVerifyInput, OtpVerifyResult, OtpMergeSuggestion, UserInputProfile, SubmitUserInputArgs, SubmitUserInputResult, TenantAdmitProjection, TenantAdmitStatus, UserUpsertErrorKind, } from "./types/user";
 export { UserUpsertError } from "./types/user";
 export { OrgDataClient, SessionOrgDataClient, createOrgDataClientFromSession, } from "./client/org-data";
 export type { OrgDataClientOptions, CreatePolicyInput, UpdateMetaInput, SetWritersInput, SetGrantsInput, DeleteGrantsInput, WriteDataInput, DeleteDataInput, DeleteScopeInput, PolicyGetInput, WritersGetInput, GrantsGetInput, DataListInput, DataGetInput, ExecuteOrgDataActionOptions, } from "./client/org-data";

package/dist/src/types/user.d.ts

@@ -138,6 +138,41 @@ export interface SubmitUserInputArgs {
      * Most callers should leave this `undefined`.
      */
     requireExistingUser?: boolean;
+    /**
+     * MAT-1618 testnet self-admit. When `true`, the contract additionally
+     * runs the self-admit side-effect after the profile commit: writes
+     * the caller's DID into `idx:_tenants` + `idx:_tenant_quotas` and
+     * mints any operator-configured welcome credits. Inspect the
+     * `tenantAdmit` field on the response for the outcome.
+     *
+     * Testnet-only. Production clusters return
+     * `tenantAdmit.status = "refused"` with
+     * `reason = "not_testnet" | "self_admit_disabled" | "not_eth_derived"`.
+     * The profile commit always succeeds regardless of the inner outcome.
+     *
+     * Most callers should leave this `undefined`.
+     */
+    becomeDevTenant?: boolean;
+}
+/**
+ * MAT-1618 self-admit projection from `user-upsert`. Present only
+ * when the caller set `becomeDevTenant: true` on the request.
+ *
+ * - `status: "admitted"` — first call for this DID; tenant record
+ *   committed and (if configured) welcome credits minted into
+ *   `grantedCredits`.
+ * - `status: "already-admitted"` — replay; idempotent no-op.
+ * - `status: "refused"` — the cluster declined the self-admit;
+ *   `reason` is the machine-readable cause (`not_testnet`,
+ *   `self_admit_disabled`, `not_eth_derived`), `detail` is a
+ *   human-readable string.
+ */
+export type TenantAdmitStatus = "admitted" | "already-admitted" | "refused";
+export interface TenantAdmitProjection {
+    status: TenantAdmitStatus;
+    grantedCredits?: string;
+    reason?: string;
+    detail?: string;
 }
 /**
  * Response shape returned by the slim `user-upsert`. Carries the
@@ -150,6 +185,11 @@ export interface SubmitUserInputResult {
     refusedFields?: string[];
     mergeSuggestion?: OtpMergeSuggestion;
     userFound?: boolean;
+    /**
+     * MAT-1618 self-admit projection. Present only when the caller
+     * set `becomeDevTenant: true` on the request.
+     */
+    tenantAdmit?: TenantAdmitProjection;
 }
 /**
  * Discriminator for {@link UserUpsertError}. Mirrors the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terminal3/t3n-sdk",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "type": "module",
   "description": "T3n TypeScript SDK - A minimal SDK that mirrors the server's RPC handler approach",
   "main": "dist/index.js",
@@ -45,6 +45,7 @@
     "demo:tenant:setup": "tsx --tsconfig tsconfig.demo.json tenant-demo.ts --cmd setup",
     "demo:tenant:search": "tsx --tsconfig tsconfig.demo.json tenant-demo.ts --cmd search",
     "demo:tenant:book": "tsx --tsconfig tsconfig.demo.json tenant-demo.ts --cmd book",
+    "demo:tenant:self-admit": "tsx --tsconfig tsconfig.demo.json demo-tenant-self-admit.ts",
     "verify:pack": "node scripts/verify-pack.js",
     "prepublishOnly": "pnpm run build:public && pnpm run verify:pack",
     "release": "node scripts/release.js release",