@contextplusplus/core 1.1.0

package/dist/application/ports/provider-registry.d.ts

@@ -0,0 +1,35 @@
+import { Effect } from "effect";
+import { EndpointDetectionError, UnsupportedUrlError } from "../../domain/errors.js";
+import type { EndpointId, ServiceId } from "../../domain/ids.js";
+import type { RuntimeProviderStrategy } from "./local-extractor.js";
+import { ProviderCatalog } from "./provider-catalog.js";
+export interface ProviderDetection {
+    readonly serviceId: ServiceId;
+    readonly endpointId: EndpointId;
+}
+type ProviderDetectionFailure = UnsupportedUrlError | EndpointDetectionError;
+declare const ProviderRegistry_base: Effect.Service.Class<ProviderRegistry, "app/ProviderRegistry", {
+    readonly effect: Effect.Effect<{
+        readonly detect: (request: {
+            readonly url: string;
+            readonly endpoint?: "auto" | "generic" | "profile" | "tweet" | "user-tweets" | "community" | "community-tweets" | "subreddit-details" | "subreddit-posts" | "subreddit-search" | "post-comments" | "user-posts" | "artist" | "artist-tracks" | "track" | "clip" | "album" | "company" | "company-posts" | "post" | "basic-profile" | "posts" | "reels" | "trending-reels" | "transcript" | "search-reels" | "comments" | "story-highlights" | "highlight-detail" | "embed-html" | "channel" | "channel-videos" | "channel-shorts" | "channel-playlists" | "channel-lives" | "channel-community-posts" | "search" | "pin" | "user-boards" | "board" | "shorts-trending" | "playlist" | "community-post" | "profile-reels" | "profile-photos" | "profile-posts" | "profile-events" | "post-transcript" | "comment-replies" | "group-posts" | "listing-detail" | "marketplace-search" | "marketplace-location-search" | "event-detail" | "event-search" | "city-events" | "ad-detail" | "ad-search" | "company-ads" | "company-search" | "advertiser-search" | "profile-region" | "user-audience" | "profile-videos" | "user-following" | "user-followers" | "user-live" | "video" | "video-transcript" | "video-comments" | "video-comment-replies" | "song" | "song-videos" | "song-reels" | "search-users" | "search-hashtag" | "search-keyword" | "search-top" | "creators-popular" | "hashtags-popular" | "trending-feed" | "shop-search" | "shop-products" | "product-details" | "product-reviews" | "user-showcase" | "user" | "user-repositories" | "user-activity" | "user-contributions" | "repository" | "trending-repositories" | "trending-developers" | "detect-age-gender" | "user-videos" | "user-schedule" | undefined;
+            readonly endpointArgs?: {
+                readonly [x: string]: string | number | boolean;
+            } | undefined;
+            readonly timeoutMs?: number | undefined;
+        }) => Effect.Effect<ProviderDetection, ProviderDetectionFailure, never>;
+        readonly plan: (request: {
+            readonly url: string;
+            readonly endpoint?: "auto" | "generic" | "profile" | "tweet" | "user-tweets" | "community" | "community-tweets" | "subreddit-details" | "subreddit-posts" | "subreddit-search" | "post-comments" | "user-posts" | "artist" | "artist-tracks" | "track" | "clip" | "album" | "company" | "company-posts" | "post" | "basic-profile" | "posts" | "reels" | "trending-reels" | "transcript" | "search-reels" | "comments" | "story-highlights" | "highlight-detail" | "embed-html" | "channel" | "channel-videos" | "channel-shorts" | "channel-playlists" | "channel-lives" | "channel-community-posts" | "search" | "pin" | "user-boards" | "board" | "shorts-trending" | "playlist" | "community-post" | "profile-reels" | "profile-photos" | "profile-posts" | "profile-events" | "post-transcript" | "comment-replies" | "group-posts" | "listing-detail" | "marketplace-search" | "marketplace-location-search" | "event-detail" | "event-search" | "city-events" | "ad-detail" | "ad-search" | "company-ads" | "company-search" | "advertiser-search" | "profile-region" | "user-audience" | "profile-videos" | "user-following" | "user-followers" | "user-live" | "video" | "video-transcript" | "video-comments" | "video-comment-replies" | "song" | "song-videos" | "song-reels" | "search-users" | "search-hashtag" | "search-keyword" | "search-top" | "creators-popular" | "hashtags-popular" | "trending-feed" | "shop-search" | "shop-products" | "product-details" | "product-reviews" | "user-showcase" | "user" | "user-repositories" | "user-activity" | "user-contributions" | "repository" | "trending-repositories" | "trending-developers" | "detect-age-gender" | "user-videos" | "user-schedule" | undefined;
+            readonly endpointArgs?: {
+                readonly [x: string]: string | number | boolean;
+            } | undefined;
+            readonly timeoutMs?: number | undefined;
+        }) => Effect.Effect<readonly RuntimeProviderStrategy[], ProviderDetectionFailure, never>;
+        readonly getStrategies: (serviceId: string & import("effect/Brand").Brand<"ServiceId">, endpointId: string & import("effect/Brand").Brand<"EndpointId">) => Effect.Effect<readonly RuntimeProviderStrategy[], never, never>;
+    }, never, ProviderCatalog>;
+}>;
+export declare class ProviderRegistry extends ProviderRegistry_base {
+}
+export {};
+//# sourceMappingURL=provider-registry.d.ts.map

package/dist/application/ports/provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.d.ts","sourceRoot":"","sources":["../../../src/application/ports/provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED,KAAK,wBAAwB,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;;;;;;;;;;;;;;;;;;;;;;AAE7E,qBAAa,gBAAiB,SAAQ,qBAyDrC;CAAG"}

package/dist/application/ports/provider-registry.js

@@ -0,0 +1,119 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e27b7156-8505-542c-acf8-d91131da7226")}catch(e){}}();
+import { Effect } from "effect";
+import { EndpointDetectionError, UnsupportedUrlError } from "../../domain/errors.js";
+import { GENERIC_URL_SERVICE_ID } from "../../domain/service-ids.js";
+import { ProviderCatalog } from "./provider-catalog.js";
+export class ProviderRegistry extends Effect.Service()("app/ProviderRegistry", {
+    effect: Effect.gen(function* () {
+        const catalog = yield* ProviderCatalog;
+        const strategies = catalog.strategies;
+        const detect = Effect.fn("ProviderRegistry.detect")((request) => detectRequest(request, strategies));
+        const plan = Effect.fn("ProviderRegistry.plan")((request) => Effect.gen(function* () {
+            const detection = yield* detect(request);
+            const exactStrategies = findStrategies(strategies, detection.serviceId, detection.endpointId);
+            if (exactStrategies.length === 0) {
+                return yield* Effect.fail(new EndpointDetectionError({
+                    url: request.url,
+                    endpoint: String(detection.endpointId)
+                }));
+            }
+            if (isGenericDetection(detection)) {
+                return exactStrategies;
+            }
+            if (isExplicitProviderEndpoint(request)) {
+                return exactStrategies;
+            }
+            const genericFallbacks = findGenericStrategies(strategies, request);
+            return [...exactStrategies, ...genericFallbacks];
+        }));
+        const getStrategies = Effect.fn("ProviderRegistry.getStrategies")((serviceId, endpointId) => Effect.succeed(findStrategies(strategies, serviceId, endpointId)));
+        return { detect, plan, getStrategies };
+    })
+}) {
+}
+function detectRequest(request, strategies) {
+    const endpoint = request.endpoint ?? "auto";
+    if (endpoint === "auto") {
+        return detectAutomaticEndpoint(request, strategies);
+    }
+    if (endpoint === "generic") {
+        return detectGenericEndpoint(request, strategies);
+    }
+    return detectExplicitEndpoint(request, endpoint, strategies);
+}
+function detectAutomaticEndpoint(request, strategies) {
+    const linkedInStrategy = strategies.find((strategy) => !isGenericStrategy(strategy) &&
+        strategy.detect(request) &&
+        !matchesServiceRoot(strategy, request));
+    if (linkedInStrategy !== undefined) {
+        return Effect.succeed({
+            serviceId: linkedInStrategy.serviceId,
+            endpointId: linkedInStrategy.endpointId
+        });
+    }
+    return detectGenericEndpoint(request, strategies);
+}
+function matchesServiceRoot(strategy, request) {
+    try {
+        const url = new URL(request.url);
+        const hostnameParts = url.hostname.split(".");
+        if (hostnameParts.length > 2 && hostnameParts[0] !== "www") {
+            return false;
+        }
+        const rootRequest = {
+            url: `${url.protocol}//${url.host}/`
+        };
+        return strategy.detect(rootRequest);
+    }
+    catch {
+        return false;
+    }
+}
+function detectGenericEndpoint(request, strategies) {
+    const genericStrategy = findGenericStrategies(strategies, request)[0];
+    if (genericStrategy === undefined) {
+        return Effect.fail(new UnsupportedUrlError({
+            url: request.url,
+            message: "No provider strategy supports this URL"
+        }));
+    }
+    return Effect.succeed({
+        serviceId: genericStrategy.serviceId,
+        endpointId: genericStrategy.endpointId
+    });
+}
+function detectExplicitEndpoint(request, endpoint, strategies) {
+    const matchingStrategies = strategies.filter((strategy) => !isGenericStrategy(strategy) && String(strategy.endpointId) === endpoint);
+    const detectedStrategy = matchingStrategies.find((strategy) => strategy.detect(request));
+    if (detectedStrategy === undefined) {
+        return Effect.fail(new EndpointDetectionError({
+            url: request.url,
+            endpoint
+        }));
+    }
+    return Effect.succeed({
+        serviceId: detectedStrategy.serviceId,
+        endpointId: detectedStrategy.endpointId
+    });
+}
+function findStrategies(strategies, serviceId, endpointId) {
+    return strategies.filter((strategy) => String(strategy.serviceId) === String(serviceId) &&
+        String(strategy.endpointId) === String(endpointId));
+}
+function isGenericDetection(detection) {
+    return String(detection.serviceId) === String(GENERIC_URL_SERVICE_ID);
+}
+function isExplicitProviderEndpoint(request) {
+    return request.endpoint !== undefined &&
+        request.endpoint !== "auto" &&
+        request.endpoint !== "generic";
+}
+function findGenericStrategies(strategies, request) {
+    return strategies.filter((strategy) => isGenericStrategy(strategy) && strategy.detect(request));
+}
+function isGenericStrategy(strategy) {
+    return String(strategy.serviceId) === String(GENERIC_URL_SERVICE_ID);
+}
+//# sourceMappingURL=provider-registry.js.map
+//# debugId=e27b7156-8505-542c-acf8-d91131da7226

package/dist/application/ports/provider-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.js","sources":["../../../src/application/ports/provider-registry.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"e27b7156-8505-542c-acf8-d91131da7226"}

package/dist/application/ports/url-safety-service.d.ts

@@ -0,0 +1,13 @@
+import { Context, Effect } from "effect";
+import { UnsafeUrlError, UnsupportedUrlError } from "../../domain/errors.js";
+declare const UrlSafetyService_base: Context.TagClass<UrlSafetyService, "app/UrlSafetyService", {
+    readonly validate: (url: string) => Effect.Effect<void, UnsafeUrlError | UnsupportedUrlError>;
+}>;
+export declare class UrlSafetyService extends UrlSafetyService_base {
+    static make(service: Context.Tag.Service<UrlSafetyService>): {
+        readonly validate: (url: string) => Effect.Effect<void, UnsafeUrlError | UnsupportedUrlError>;
+    };
+}
+export type UrlSafetyServiceApi = Context.Tag.Service<typeof UrlSafetyService>;
+export {};
+//# sourceMappingURL=url-safety-service.d.ts.map

package/dist/application/ports/url-safety-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-safety-service.d.ts","sourceRoot":"","sources":["../../../src/application/ports/url-safety-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;;uBAKtD,CACjB,GAAG,EAAE,MAAM,KACR,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,mBAAmB,CAAC;;AALlE,qBAAa,gBAAiB,SAAQ,qBAOnC;IACD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC;2BALrC,CACjB,GAAG,EAAE,MAAM,KACR,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,mBAAmB,CAAC;;CAMjE;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/application/ports/url-safety-service.js

@@ -0,0 +1,11 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b98ae55e-bd06-5b37-abd7-96c2227b89a0")}catch(e){}}();
+import { Context, Effect } from "effect";
+import { UnsafeUrlError, UnsupportedUrlError } from "../../domain/errors.js";
+export class UrlSafetyService extends Context.Tag("app/UrlSafetyService")() {
+    static make(service) {
+        return service;
+    }
+}
+//# sourceMappingURL=url-safety-service.js.map
+//# debugId=b98ae55e-bd06-5b37-abd7-96c2227b89a0

package/dist/application/ports/url-safety-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-safety-service.js","sources":["../../../src/application/ports/url-safety-service.ts"],"sourceRoot":"","names":[],"mappings":";;AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7E,MAAM,OAAO,gBAAiB,SAAQ,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAOtE;IACD,MAAM,CAAC,IAAI,CAAC,OAA8C;QACxD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF","debugId":"b98ae55e-bd06-5b37-abd7-96c2227b89a0"}

package/dist/application/ports/usage-service.d.ts

@@ -0,0 +1,234 @@
+import { Context, type Effect } from "effect";
+import type { AccountSuspendedError, BillingStateError, QuotaExceededError, SubscriptionRequiredError } from "../../domain/errors.js";
+import type { UserId } from "../../domain/ids.js";
+export interface QuotaDecision {
+    readonly allowed: boolean;
+    readonly plan: string;
+    readonly usageCount: number;
+    readonly limit: number;
+    /**
+     * The exact billing period (`YYYY-MM-DD`) the reservation incremented. The
+     * boundary passes this back to {@link UsageServiceApi.releaseQuota} so a
+     * release targets the same counter row the reservation touched, rather than
+     * re-deriving the period (which can resolve to a different row and silently
+     * no-op the decrement).
+     */
+    readonly periodStart: string;
+}
+export interface UsageSnapshot {
+    readonly planTier: string;
+    readonly monthlyLimit: number;
+    readonly used: number;
+    readonly remaining: number;
+    readonly periodEnd: string | null;
+    readonly subscriptionStatus: string;
+    readonly entitled: boolean;
+}
+/**
+ * One purchasable subscription tier as exposed by the self-serve plans surface.
+ * The Stripe price id is deliberately omitted — the public surface stays minimal
+ * and reveals only what the upgrade/downgrade UX needs.
+ */
+export interface PlanTierInfo {
+    readonly plan: string;
+    readonly monthlyLimit: number;
+    readonly priceCents: number;
+    /** True for the tier the caller is currently subscribed to. */
+    readonly current: boolean;
+}
+/**
+ * The available tiers plus the caller's current plan. `currentPlan` is `null`
+ * when the caller has no active subscription; the full tier list is still
+ * returned so the UI can offer an upgrade.
+ */
+export interface PlanList {
+    readonly plans: ReadonlyArray<PlanTierInfo>;
+    readonly currentPlan: string | null;
+}
+/** One tier row in the admin usage overview: subscribers + reserved units. */
+export interface AdminTierUsage {
+    readonly plan: string;
+    readonly subscribers: number;
+    readonly usageUnits: number;
+}
+/** One heaviest-consumer row in the admin usage overview. */
+export interface AdminTopUser {
+    readonly userId: string;
+    readonly plan: string;
+    readonly used: number;
+}
+/**
+ * Operator-facing, current-period usage aggregate. Read-only and derived from
+ * `user_monthly_usage` + `subscriptions` + `plan_tiers` via the service-role
+ * client (bypasses RLS server-side). Never exposes Stripe ids, secrets, or
+ * emails — only the aggregate counts an operator needs.
+ */
+export interface AdminUsageOverview {
+    readonly totalUsers: number;
+    readonly totalUsageThisPeriod: number;
+    readonly perTier: ReadonlyArray<AdminTierUsage>;
+    readonly topUsers: ReadonlyArray<AdminTopUser>;
+}
+/** One subscription row in the admin subscriptions listing. */
+export interface AdminSubscription {
+    readonly userId: string;
+    readonly plan: string | null;
+    readonly status: string;
+    readonly currentPeriodEnd: string | null;
+}
+/** A bounded page of subscription rows plus the total matched count. */
+export interface AdminSubscriptionList {
+    readonly subscriptions: ReadonlyArray<AdminSubscription>;
+    readonly total: number;
+}
+/** Bounded pagination window for {@link UsageServiceApi.listAdminSubscriptions}. */
+export interface AdminSubscriptionsQuery {
+    readonly limit: number;
+    readonly offset: number;
+}
+/** One row of the caller's own usage-event ledger (analytics history). */
+export interface UsageEventRecord {
+    readonly id: string;
+    readonly endpoint: string | null;
+    readonly units: number;
+    readonly provider: string | null;
+    readonly outcome: string | null;
+    /** Correlation id lifted out of the event metadata, when present. */
+    readonly runId: string | null;
+    readonly createdAt: string;
+}
+/** Bounded, optionally time-filtered window over the usage-event ledger. */
+export interface UsageHistoryQuery {
+    /** Inclusive ISO-8601 lower bound on event time (omitted → unbounded). */
+    readonly start?: string;
+    /** Inclusive ISO-8601 upper bound on event time (omitted → unbounded). */
+    readonly end?: string;
+    readonly limit: number;
+    readonly offset: number;
+}
+/** A page of usage events plus the total matched count and echoed window. */
+export interface UsageEventPage {
+    readonly events: ReadonlyArray<UsageEventRecord>;
+    readonly total: number;
+    readonly limit: number;
+    readonly offset: number;
+}
+export type UsageOutcome = "success" | "failed" | "partial";
+/**
+ * Analytics ledger entry written after upstream work completes. Never carries
+ * the request payload or any secret — only attribution + outcome.
+ */
+export interface UsageRecord {
+    readonly userId: UserId;
+    readonly endpoint: string;
+    readonly units: number;
+    readonly outcome: UsageOutcome;
+    readonly provider?: string;
+    readonly runId?: string;
+}
+/**
+ * Reserving a quota unit can fail because the user has no active subscription
+ * (402), is over their tier limit (429), or because the billing backend is
+ * unreachable / inconsistent (500).
+ */
+export type QuotaCheckError = AccountSuspendedError | SubscriptionRequiredError | QuotaExceededError | BillingStateError;
+export interface UsageServiceApi {
+    /**
+     * Reads the caller's current subscription + reserved usage snapshot without
+     * mutating quota. This is an account/control-plane read; enforcement remains
+     * in {@link checkAndReserveQuota}.
+     */
+    readonly getUsageSnapshot: (userId: UserId) => Effect.Effect<UsageSnapshot, BillingStateError, never>;
+    /**
+     * Lists every purchasable subscription tier (sorted by ascending price) and
+     * marks the caller's current plan. A control-plane read for the self-serve
+     * upgrade/downgrade UX; never mutates quota or subscription state.
+     */
+    readonly listPlans: (userId: UserId) => Effect.Effect<PlanList, BillingStateError, never>;
+    /**
+     * Reads a bounded, optionally time-filtered page of the caller's OWN
+     * usage-event ledger (newest first). A control-plane read; never mutates
+     * quota. The `userId` is the only attribution key — callers must pass the
+     * authenticated user's id, never a client-supplied value.
+     */
+    readonly listUsageEvents: (userId: UserId, query: UsageHistoryQuery) => Effect.Effect<UsageEventPage, BillingStateError, never>;
+    /**
+     * Atomically reserves one (or more) usage units for the user against their
+     * active plan. Resolves with the decision when allowed; fails fast — before
+     * any provider dispatch — when the subscription is missing or over quota.
+     */
+    readonly checkAndReserveQuota: (userId: UserId) => Effect.Effect<QuotaDecision, QuotaCheckError, never>;
+    /**
+     * Releases a previously reserved quota unit (decrement, floored at 0) for the
+     * EXACT period the reservation incremented. Used to implement
+     * charge-on-success: when the engine fails, is interrupted, or returns a
+     * non-`success` run after {@link checkAndReserveQuota} reserved a unit, the
+     * boundary releases it so a failing request never burns the caller's monthly
+     * quota (self-DoS). The caller passes back `periodStart` from the
+     * {@link QuotaDecision} the reservation returned; the release MUST NOT
+     * re-derive the period, since a fresh derivation can target a different
+     * counter row and silently lose the unit. Callers treat failures as non-fatal
+     * so a release write never masks the original engine error.
+     */
+    readonly releaseQuota: (userId: UserId, periodStart: string, units: number) => Effect.Effect<void, BillingStateError, never>;
+    /**
+     * Reversibly blocks or restores a user at the profile level. Admin-only at
+     * the HTTP boundary; the live implementation writes via service_role.
+     */
+    readonly setSuspended: (userId: UserId, suspended: boolean) => Effect.Effect<void, BillingStateError, never>;
+    /**
+     * Resets the user's current-period reserved usage to zero. Admin-only at the
+     * HTTP boundary; idempotent when no current-period row exists.
+     */
+    readonly resetCurrentUsage: (userId: UserId) => Effect.Effect<void, BillingStateError, never>;
+    /**
+     * Appends an analytics usage event. Callers treat failures as non-fatal
+     * (fire-and-forget) so a ledger write never breaks a successful response.
+     */
+    readonly recordUsage: (record: UsageRecord) => Effect.Effect<void, BillingStateError, never>;
+    /**
+     * True when `userId` is in the configured admin allowlist (`ADMIN_USER_IDS`).
+     * A pure config lookup with no I/O; the HTTP boundary uses it to gate the
+     * admin read routes and raise `ForbiddenError` (403) for non-admins.
+     */
+    readonly isAdmin: (userId: UserId) => Effect.Effect<boolean, never, never>;
+    /**
+     * Operator-facing current-period usage aggregate (service-role, bypasses RLS).
+     * Read-only; never mutates quota or subscription state and never exposes
+     * Stripe ids, secrets, or emails. Admin authorization is enforced by the
+     * caller via {@link isAdmin} before this is invoked.
+     */
+    readonly getAdminUsageOverview: () => Effect.Effect<AdminUsageOverview, BillingStateError, never>;
+    /**
+     * Operator-facing, paginated subscription listing (service-role, bypasses
+     * RLS). Read-only; exposes only userId + plan + status + period end. Admin
+     * authorization is enforced by the caller via {@link isAdmin}.
+     */
+    readonly listAdminSubscriptions: (query: AdminSubscriptionsQuery) => Effect.Effect<AdminSubscriptionList, BillingStateError, never>;
+    /**
+     * Records `credits` of provider spend against today's (UTC) global daily
+     * counter and reports whether the configured daily ceiling is now reached.
+     * No-op returning `{ tripped: false }` when the ceiling is disabled (config
+     * `DAILY_PROVIDER_SPEND_CEILING_CREDITS <= 0`) or `credits <= 0`. Best-effort:
+     * a DB failure is logged, never surfaced (spend accounting must not break a
+     * served request).
+     */
+    readonly recordProviderSpend: (credits: number) => Effect.Effect<{
+        readonly tripped: boolean;
+    }, never, never>;
+    /**
+     * True when the daily provider-spend ceiling has been reached for the current
+     * UTC day (an in-process flag updated by {@link recordProviderSpend}). Always
+     * false when the ceiling is disabled. The server-side metered entry points
+     * check this BEFORE running the engine and raise
+     * `ProviderSpendCeilingExceededError` (503) so no further provider credit is
+     * spent until the day rolls over or the ceiling is raised.
+     */
+    readonly spendCeilingTripped: () => Effect.Effect<boolean, never, never>;
+}
+declare const UsageService_base: Context.TagClass<UsageService, "app/UsageService", UsageServiceApi>;
+export declare class UsageService extends UsageService_base {
+    static make(service: Context.Tag.Service<UsageService>): UsageServiceApi;
+}
+export {};
+//# sourceMappingURL=usage-service.d.ts.map

package/dist/application/ports/usage-service.d.ts.map

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

package/dist/application/ports/usage-service.js

@@ -0,0 +1,10 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="fce52ff4-735e-5d93-af99-ee59e8ddfd75")}catch(e){}}();
+import { Context } from "effect";
+export class UsageService extends Context.Tag("app/UsageService")() {
+    static make(service) {
+        return service;
+    }
+}
+//# sourceMappingURL=usage-service.js.map
+//# debugId=fce52ff4-735e-5d93-af99-ee59e8ddfd75

package/dist/application/ports/usage-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-service.js","sources":["../../../src/application/ports/usage-service.ts"],"sourceRoot":"","names":[],"mappings":";;AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,QAAQ,CAAC;AAyR9C,MAAM,OAAO,YAAa,SAAQ,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAG9D;IACD,MAAM,CAAC,IAAI,CAAC,OAA0C;QACpD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF","debugId":"fce52ff4-735e-5d93-af99-ee59e8ddfd75"}

package/dist/application/scheduling/provider-scheduler.d.ts

@@ -0,0 +1,16 @@
+import { Effect, Scope } from "effect";
+import { ConfigurationError } from "../../domain/errors.js";
+import type { ProviderId } from "../../domain/ids.js";
+import type { RatePolicy } from "../../domain/provider.js";
+import { ConfigService } from "../ports/config-service.js";
+import { ThroughputController } from "./throughput-controller.js";
+declare const ProviderScheduler_base: Effect.Service.Class<ProviderScheduler, "app/ProviderScheduler", {
+    readonly scoped: Effect.Effect<{
+        readonly schedule: <A, E, R>(providerId: ProviderId, ratePolicy: RatePolicy, cost: number, task: Effect.Effect<A, E, R>) => Effect.Effect<A, E | ConfigurationError, R>;
+    }, never, ConfigService | ThroughputController | Scope.Scope>;
+    readonly dependencies: readonly [import("effect/Layer").Layer<ThroughputController, never, never>];
+}>;
+export declare class ProviderScheduler extends ProviderScheduler_base {
+}
+export {};
+//# sourceMappingURL=provider-scheduler.d.ts.map

package/dist/application/scheduling/provider-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-scheduler.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/provider-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAe,KAAK,EAAmB,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;;;4BAuE1C,CAAC,EAAE,CAAC,EAAE,CAAC,cACX,UAAU,cACV,UAAU,QAChB,MAAM,QACN,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAC,CAAC;;;;AAnEpD,qBAAa,iBAAkB,SAAQ,sBAoFtC;CAAG"}

package/dist/application/scheduling/provider-scheduler.js

@@ -0,0 +1,82 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5ad29bcf-7625-5726-9545-8e86d42699f1")}catch(e){}}();
+import { Effect, RateLimiter, Scope, SynchronizedRef } from "effect";
+import { ConfigurationError } from "../../domain/errors.js";
+import { ConfigService } from "../ports/config-service.js";
+import { ThroughputController } from "./throughput-controller.js";
+export class ProviderScheduler extends Effect.Service()("app/ProviderScheduler", {
+    scoped: Effect.gen(function* () {
+        const { config } = yield* ConfigService;
+        const throughput = yield* ThroughputController;
+        const scope = yield* Scope.Scope;
+        const states = yield* SynchronizedRef.make(new Map());
+        const getOrCreate = (providerId, ratePolicy) => {
+            const policyKey = makePolicyKey(ratePolicy, config.defaultUtilizationTarget);
+            const mapKey = String(providerId);
+            return SynchronizedRef.modifyEffect(states, (current) => {
+                const existing = current.get(mapKey);
+                if (existing !== undefined && existing.policyKey === policyKey) {
+                    return Effect.succeed([existing, current]);
+                }
+                return Effect.gen(function* () {
+                    const computed = throughput.compute({
+                        ...ratePolicy,
+                        utilizationTarget: normalizedUtilizationTarget(ratePolicy, config.defaultUtilizationTarget)
+                    });
+                    if (computed.effectiveLimit < 1) {
+                        return yield* Effect.fail(new ConfigurationError({
+                            key: `provider.${String(providerId)}.ratePolicy`,
+                            message: "Provider effective rate limit must be at least 1"
+                        }));
+                    }
+                    const semaphore = yield* Effect.makeSemaphore(Math.max(1, Math.floor(ratePolicy.maxConcurrency)));
+                    const limiter = yield* RateLimiter.make({
+                        limit: computed.effectiveLimit,
+                        interval: ratePolicy.interval,
+                        algorithm: ratePolicy.algorithm ?? "fixed-window"
+                    }).pipe(Effect.provideService(Scope.Scope, scope));
+                    const state = {
+                        semaphore,
+                        limiter,
+                        policyKey,
+                        effectiveLimit: computed.effectiveLimit
+                    };
+                    const next = new Map(current);
+                    next.set(mapKey, state);
+                    return [state, next];
+                });
+            });
+        };
+        const schedule = (providerId, ratePolicy, cost, task) => getOrCreate(providerId, ratePolicy).pipe(Effect.flatMap(({ semaphore, limiter, effectiveLimit }) => validateCost(providerId, cost, effectiveLimit).pipe(Effect.zipRight(limiter(semaphore.withPermits(1)(task)).pipe(RateLimiter.withCost(Math.max(1, Math.ceil(cost))))))));
+        return { schedule };
+    }),
+    dependencies: [ThroughputController.Default]
+}) {
+}
+function makePolicyKey(ratePolicy, defaultUtilizationTarget) {
+    return JSON.stringify({
+        algorithm: ratePolicy.algorithm ?? "fixed-window",
+        documentedLimit: ratePolicy.documentedLimit,
+        interval: ratePolicy.interval,
+        utilizationTarget: Number.isFinite(ratePolicy.utilizationTarget) && ratePolicy.utilizationTarget > 0
+            ? ratePolicy.utilizationTarget
+            : defaultUtilizationTarget,
+        maxConcurrency: ratePolicy.maxConcurrency
+    });
+}
+function validateCost(providerId, cost, effectiveLimit) {
+    const normalizedCost = Math.max(1, Math.ceil(cost));
+    return normalizedCost > effectiveLimit
+        ? Effect.fail(new ConfigurationError({
+            key: `provider.${String(providerId)}.cost`,
+            message: `Provider request cost ${normalizedCost} exceeds effective limit ${effectiveLimit}`
+        }))
+        : Effect.void;
+}
+function normalizedUtilizationTarget(ratePolicy, defaultUtilizationTarget) {
+    return Number.isFinite(ratePolicy.utilizationTarget) && ratePolicy.utilizationTarget > 0
+        ? ratePolicy.utilizationTarget
+        : defaultUtilizationTarget;
+}
+//# sourceMappingURL=provider-scheduler.js.map
+//# debugId=5ad29bcf-7625-5726-9545-8e86d42699f1

package/dist/application/scheduling/provider-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-scheduler.js","sources":["../../../src/application/scheduling/provider-scheduler.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"5ad29bcf-7625-5726-9545-8e86d42699f1"}

package/dist/application/scheduling/throughput-controller.d.ts

@@ -0,0 +1,20 @@
+import { Effect } from "effect";
+import type { ProviderId } from "../../domain/ids.js";
+import type { RatePolicy } from "../../domain/provider.js";
+import type { UtilizationMetadata } from "../../domain/response-envelope.js";
+export interface ThroughputDecision {
+    readonly documentedLimit: number;
+    readonly effectiveLimit: number;
+    readonly utilizationTarget: number;
+    readonly headroom: number;
+}
+declare const ThroughputController_base: Effect.Service.Class<ThroughputController, "app/ThroughputController", {
+    readonly effect: Effect.Effect<{
+        readonly compute: (policy: RatePolicy) => ThroughputDecision;
+        readonly observe: (providerId: ProviderId, ratePolicy: RatePolicy) => Effect.Effect<UtilizationMetadata, never, never>;
+    }, never, never>;
+}>;
+export declare class ThroughputController extends ThroughputController_base {
+}
+export {};
+//# sourceMappingURL=throughput-controller.d.ts.map

package/dist/application/scheduling/throughput-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throughput-controller.d.ts","sourceRoot":"","sources":["../../../src/application/scheduling/throughput-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;;;mCAM8B,UAAU,KAAG,kBAAkB;uCAc1C,UAAU,cACV,UAAU,KACrB,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,KAAK,EAAE,KAAK,CAAC;;;AApBzD,qBAAa,oBAAqB,SAAQ,yBAmCzC;CAAG"}