Directories
¶
| Path | Synopsis |
|---|---|
|
Package app is the root of the application layer: one subpackage per bounded context, holding its command and query handlers.
|
Package app is the root of the application layer: one subpackage per bounded context, holding its command and query handlers. |
|
access
Package access holds the use cases of the access context: members, the instance admin, API tokens and the authentication of their callers.
|
Package access holds the use cases of the access context: members, the instance admin, API tokens and the authentication of their callers. |
|
delivery
Package delivery holds the use cases of the delivery context: moving an environment's ruleset version on when a write changes what its SDKs receive, evaluating its ruleset for a context to explain what the context is served, and serving the SDKs themselves: their keys and the authentication of a request by one, remote evaluation, the ruleset and its stream, the attributes discovered in the contexts evaluated, and the inventory of the SDKs seen.
|
Package delivery holds the use cases of the delivery context: moving an environment's ruleset version on when a write changes what its SDKs receive, evaluating its ruleset for a context to explain what the context is served, and serving the SDKs themselves: their keys and the authentication of a request by one, remote evaluation, the ruleset and its stream, the attributes discovered in the contexts evaluated, and the inventory of the SDKs seen. |
|
events
Package events holds the use cases of the events context: ingest of the events SDKs post.
|
Package events holds the use cases of the events context: ingest of the events SDKs post. |
|
experiments
Package experiments holds the use cases of the experiments context.
|
Package experiments holds the use cases of the experiments context. |
|
flags
Package flags holds the use cases of the flags context: flags, their configuration in each environment, and segments.
|
Package flags holds the use cases of the flags context: flags, their configuration in each environment, and segments. |
|
governance
Package governance holds the use cases of the governance context: recording the audit entries of every context and reading the audit log.
|
Package governance holds the use cases of the governance context: recording the audit entries of every context and reading the audit log. |
|
identity
Package identity holds the use cases of the identity context: the auth providers an instance admin configures and, as they arrive, the sign-ins, identities and directory provisioning built on them.
|
Package identity holds the use cases of the identity context: the auth providers an instance admin configures and, as they arrive, the sign-ins, identities and directory provisioning built on them. |
|
sinks
Package sinks holds the use cases of a project's sinks: the resource a maintainer creates, reads, edits and deletes, whose credentials are sealed and never read back.
|
Package sinks holds the use cases of a project's sinks: the resource a maintainer creates, reads, edits and deletes, whose credentials are sealed and never read back. |
|
transfer
Package transfer holds the use cases of the transfer context: a project's configuration leaving the platform as a project document.
|
Package transfer holds the use cases of the transfer context: a project's configuration leaving the platform as a project document. |
|
workspace
Package workspace holds the use cases of the workspace context: projects, their environments, unit types and attributes.
|
Package workspace holds the use cases of the workspace context: projects, their environments, unit types and attributes. |
|
Package domain is the root of the domain layer: one subpackage per bounded context, holding its entities, value objects and invariants.
|
Package domain is the root of the domain layer: one subpackage per bounded context, holding its entities, value objects and invariants. |
|
access
Package access is the domain of who may do what: members and the instance admin, API tokens and their scopes, the permission catalog, the built-in roles and how a caller is judged against what an operation requires.
|
Package access is the domain of who may do what: members and the instance admin, API tokens and their scopes, the permission catalog, the built-in roles and how a caller is judged against what an operation requires. |
|
delivery
Package delivery is the domain of what an environment's SDKs receive: the ruleset materialized from its flags, segments and declarations, and the evaluation of it that explains what a context is served.
|
Package delivery is the domain of what an environment's SDKs receive: the ruleset materialized from its flags, segments and declarations, and the evaluation of it that explains what a context is served. |
|
events
Package events is the domain of the events context: the events SDKs post, how each is judged on its own, and how an exposure is judged against the experiment it names.
|
Package events is the domain of the events context: the events SDKs post, how each is judged on its own, and how an exposure is judged against the experiment it names. |
|
experiments
Package experiments is the domain of experiments: a time-boxed comparison of variations of one flag on a declared unit type, with a hypothesis, an owner, weights, a traffic allocation and two public salts.
|
Package experiments is the domain of experiments: a time-boxed comparison of variations of one flag on a declared unit type, with a hypothesis, an owner, weights, a traffic allocation and two public salts. |
|
flags
Package flags is the domain of what a project serves: flags with their definition and variations, their configuration in each environment, and the segments their rules target.
|
Package flags is the domain of what a project serves: flags with their definition and variations, their configuration in each environment, and the segments their rules target. |
|
governance
Package governance is the domain of how changes are governed: the audit entry (who changed what, when, from which value to which), change requests, the events that changes cause, webhook subscriptions and their deliveries, and the notices of the change stream.
|
Package governance is the domain of how changes are governed: the audit entry (who changed what, when, from which value to which), change requests, the events that changes cause, webhook subscriptions and their deliveries, and the notices of the change stream. |
|
identity
Package identity holds the rules of the integrations that reach outside the instance to know who a person is: the auth providers an instance admin configures, and, as they arrive, the identities, sign-in attempts and directory provisioning built on them.
|
Package identity holds the rules of the integrations that reach outside the instance to know who a person is: the auth providers an instance admin configures, and, as they arrive, the identities, sign-in attempts and directory provisioning built on them. |
|
sinks
Package sinks holds a project's sinks: the standing request to copy its raw events to a ClickHouse database, an S3-compatible bucket or a signed webhook.
|
Package sinks holds a project's sinks: the standing request to copy its raw events to a ClickHouse database, an S3-compatible bucket or a signed webhook. |
|
transfer
Package transfer is the domain of moving a project's configuration in and out of the platform as one project document: the document's types, its byte-stable encodings in JSON and YAML, and its strict decoding.
|
Package transfer is the domain of moving a project's configuration in and out of the platform as one project document: the document's types, its byte-stable encodings in JSON and YAML, and its strict decoding. |
|
transfer/firebase
Package firebase translates a Firebase Remote Config template into the flags, rules and attributes to merge into one environment: parameters become flags, conditional values become rules, and everything the translation cannot reproduce becomes a coded warning pointing into the template.
|
Package firebase translates a Firebase Remote Config template into the flags, rules and attributes to merge into one environment: parameters become flags, conditional values become rules, and everything the translation cannot reproduce becomes a coded warning pointing into the template. |
|
workspace
Package workspace is the domain of where flags live: projects, their environments, and the unit types and attributes their targeting refers to.
|
Package workspace is the domain of where flags live: projects, their environments, and the unit types and attributes their targeting refers to. |
|
Package infra is the root of the infrastructure layer.
|
Package infra is the root of the infrastructure layer. |
|
compose
Package compose assembles a replica: it builds the application's handlers on their PostgreSQL and other outbound adapters and mounts the APIs on the edge.
|
Package compose assembles a replica: it builds the application's handlers on their PostgreSQL and other outbound adapters and mounts the APIs on the edge. |
|
config
Package config is the server's configuration: one table declares every setting, and the loader, the keys of the configuration file and the public reference (docs/configuration.md) are all derived from it, so the reference cannot fall behind what the server reads.
|
Package config is the server's configuration: one table declares every setting, and the loader, the keys of the configuration file and the public reference (docs/configuration.md) are all derived from it, so the reference cannot fall behind what the server reads. |
|
in/cli
Package cli is the flagnetic command line.
|
Package cli is the flagnetic command line. |
|
in/http
Package http is the server's HTTP edge: the public handler with its health and readiness probes, onto which the APIs and the console are mounted.
|
Package http is the server's HTTP edge: the public handler with its health and readiness probes, onto which the APIs and the console are mounted. |
|
in/http/console
Package console serves the web console the binary embeds: the build of web/apps/console, or a placeholder page when the binary was built without it, so `go build` never needs Node.
|
Package console serves the web console the binary embeds: the build of web/apps/console, or a placeholder page when the binary was built without it, so `go build` never needs Node. |
|
in/http/deprecation
Package deprecation announces deprecated operations on the wire.
|
Package deprecation announces deprecated operations on the wire. |
|
in/http/management
Package management provides primitives to interact with the openapi HTTP API.
|
Package management provides primitives to interact with the openapi HTTP API. |
|
in/http/management/operations
Package operations reads what each operation of the management API requires from its OpenAPI document, and holds the table generated from it that the permission seam reads.
|
Package operations reads what each operation of the management API requires from its OpenAPI document, and holds the table generated from it that the permission seam reads. |
|
in/http/scim
Package scim provides primitives to interact with the openapi HTTP API.
|
Package scim provides primitives to interact with the openapi HTTP API. |
|
in/http/sdk
Package sdk provides primitives to interact with the openapi HTTP API.
|
Package sdk provides primitives to interact with the openapi HTTP API. |
|
in/http/sso
Package sso is the browser edge of single sign-on: the addresses a browser is sent through to sign in at an auth provider, outside the management API because every step is a navigation, not a call.
|
Package sso is the browser edge of single sign-on: the addresses a browser is sent through to sign in at an auth provider, outside the management API because every step is a navigation, not a call. |
|
in/worker
Package worker runs a replica's background work in rounds.
|
Package worker runs a replica's background work in rounds. |
|
metrics
Package metrics is the replica's Prometheus registry and the listener that serves it.
|
Package metrics is the replica's Prometheus registry and the listener that serves it. |
|
out/idphttp
Package idphttp is the HTTP client every request to an identity provider is made with, whatever the protocol it speaks.
|
Package idphttp is the HTTP client every request to an identity provider is made with, whatever the protocol it speaks. |
|
out/mail
Package mail is the outbound mail adapter: the templates every kind of mail is written from, in every language, and the SMTP sender.
|
Package mail is the outbound mail adapter: the templates every kind of mail is written from, in every language, and the SMTP sender. |
|
out/oidc
Package oidc is the outbound adapter to OpenID Connect providers, built on go-oidc.
|
Package oidc is the outbound adapter to OpenID Connect providers, built on go-oidc. |
|
out/password
Package password hashes members' passwords with argon2id.
|
Package password hashes members' passwords with argon2id. |
|
out/postgres
Package postgres is the server's PostgreSQL: the connection pool, the check that the server is a supported version, and the schema migrations embedded in the binary.
|
Package postgres is the server's PostgreSQL: the connection pool, the check that the server is a supported version, and the schema migrations embedded in the binary. |
|
out/postgres/access
Package access is the PostgreSQL repository of the access context: members, API tokens and sessions.
|
Package access is the PostgreSQL repository of the access context: members, API tokens and sessions. |
|
out/postgres/delivery
Package delivery is the PostgreSQL repository of the delivery context: for now, the ruleset version of each environment.
|
Package delivery is the PostgreSQL repository of the delivery context: for now, the ruleset version of each environment. |
|
out/postgres/events
Package events is the PostgreSQL repository of the events context: the raw events SDKs post and the tables that keep them apart from retries.
|
Package events is the PostgreSQL repository of the events context: the raw events SDKs post and the tables that keep them apart from retries. |
|
out/postgres/experiments
Package experiments is the PostgreSQL repository of the experiments context.
|
Package experiments is the PostgreSQL repository of the experiments context. |
|
out/postgres/flags
Package flags is the PostgreSQL repository of the flags context: flags, their configuration in each environment, and segments.
|
Package flags is the PostgreSQL repository of the flags context: flags, their configuration in each environment, and segments. |
|
out/postgres/governance
Package governance is the PostgreSQL repository of the governance context: the audit log, change requests, webhook subscriptions with their outbox and deliveries, the change stream and stale-flag digests.
|
Package governance is the PostgreSQL repository of the governance context: the audit log, change requests, webhook subscriptions with their outbox and deliveries, the change stream and stale-flag digests. |
|
out/postgres/identity
Package identity is the PostgreSQL repository of the identity context: auth providers.
|
Package identity is the PostgreSQL repository of the identity context: auth providers. |
|
out/postgres/projectrow
Package projectrow records, for the life of a transaction, the projects whose row it locked FOR NO KEY UPDATE, the lock every write of a project takes so that the project's writes run one at a time.
|
Package projectrow records, for the life of a transaction, the projects whose row it locked FOR NO KEY UPDATE, the lock every write of a project takes so that the project's writes run one at a time. |
|
out/postgres/sinks
Package sinks is the PostgreSQL repository of a project's sinks.
|
Package sinks is the PostgreSQL repository of a project's sinks. |
|
out/postgres/workspace
Package workspace is the PostgreSQL repository of the workspace context: projects, their environments, unit types and attributes.
|
Package workspace is the PostgreSQL repository of the workspace context: projects, their environments, unit types and attributes. |
|
out/saml
Package saml is the outbound adapter to SAML identity providers: the instance as a service provider, built on gosaml2 and goxmldsig.
|
Package saml is the outbound adapter to SAML identity providers: the instance as a service provider, built on gosaml2 and goxmldsig. |
|
out/sinks
Package sinks makes the HTTP calls of sinks: the clients each kind of target is called with, guarded by kind, and the reduction of whatever a target answers to a failure class.
|
Package sinks makes the HTTP calls of sinks: the clients each kind of target is called with, guarded by kind, and the reduction of whatever a target answers to a failure class. |
|
out/testclock
Package testclock is the test-only clock of FLAGNETIC_TEST_CLOCK_FILE: the wall clock moved ahead by the duration a file holds, such as "25h".
|
Package testclock is the test-only clock of FLAGNETIC_TEST_CLOCK_FILE: the wall clock moved ahead by the duration a file holds, such as "25h". |
|
out/webhook
Package webhook makes the HTTP calls of webhook deliveries.
|
Package webhook makes the HTTP calls of webhook deliveries. |
|
pkg
|
|
|
buildinfo
Package buildinfo reports the version the running binary was built from.
|
Package buildinfo reports the version the running binary was built from. |
|
pglisten
Package pglisten keeps a process listening on a PostgreSQL notification channel, and tells it when it is not.
|
Package pglisten keeps a process listening on a PostgreSQL notification channel, and tells it when it is not. |
|
pgtest
Package pgtest gives a test package a real PostgreSQL, so that no test fakes the database.
|
Package pgtest gives a test package a real PostgreSQL, so that no test fakes the database. |
|
pgxtx
Package pgxtx carries a PostgreSQL transaction in a context, so the code that owns a unit of work begins it and the code that runs statements finds it, without the transaction appearing in any signature in between.
|
Package pgxtx carries a PostgreSQL transaction in a context, so the code that owns a unit of work begins it and the code that runs statements finds it, without the transaction appearing in any signature in between. |
|
safego
Package safego runs functions so that a panic in one is recovered, logged with its stack and counted, rather than crashing the process: one poison input must not take every process that reads it down with it.
|
Package safego runs functions so that a panic in one is recovered, logged with its stack and counted, rather than crashing the process: one poison input must not take every process that reads it down with it. |
|
Package shared is the root of the kernel every layer may import: error kinds, identifiers, the clock and secret values.
|
Package shared is the root of the kernel every layer may import: error kinds, identifiers, the clock and secret values. |
|
clock
Package clock is the one time source of the server.
|
Package clock is the one time source of the server. |
|
errors
Package errors is the one way domain and application code says what went wrong: an error of a fixed kind with a stable code.
|
Package errors is the one way domain and application code says what went wrong: an error of a fixed kind with a stable code. |
|
id
Package id is the identifiers of every entity: UUIDv7 values minted by the application before the domain sees them, typed per entity.
|
Package id is the identifiers of every entity: UUIDv7 values minted by the application before the domain sees them, typed per entity. |
|
precondition
Package precondition is how a write names the version of the entity it was based on, and how that version is judged against the stored one.
|
Package precondition is how a write names the version of the entity it was based on, and how that version is judged against the stored one. |
|
protection
Package protection carries, in a context, which protected environments a write may change without a change request, as the context carries the write's transaction.
|
Package protection carries, in a context, which protected environments a write may change without a change request, as the context carries the write's transaction. |
|
secret
Package secret holds values that must never reach a log: passwords, keys, tokens.
|
Package secret holds values that must never reach a log: passwords, keys, tokens. |
|
subnet
Package subnet groups client addresses the way limits count them.
|
Package subnet groups client addresses the way limits count them. |
|
text
Package text is the one rule for the text a client sends: it holds no control character other than a tab or a line break.
|
Package text is the one rule for the text a client sends: it holds no control character other than a tab or a line break. |
|
Package testkit is the Flagnetic test kit: a real, migrated PostgreSQL for every test package, and the fake clock, deterministic identifiers and log sink a test hands to the code under test.
|
Package testkit is the Flagnetic test kit: a real, migrated PostgreSQL for every test package, and the fake clock, deterministic identifiers and log sink a test hands to the code under test. |
Click to show internal directories.
Click to hide internal directories.